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HOW TO USE 
THIS MANUAL 


This manual has been developed with the user in mö nd. Bach section of Information 
represents one phase of the third version of the AT/^RI Disk Operating System 
(DOS 3). The newcomer to DOS can easily find the 5 Information needed to get 
started with DOS 3 without feeling encumbered b y & xtraneous Information. The 
experienced user, however, can quickly find and use the data required to perform 
more complex operations. 


FOR THE NEW DOS USER 

Section 1 explains how to use this manual and the rocedures for the most 
elementary operations: 

■ Definition of DOS 

■ Setting up the system 

■ Explaining the DOS Menu 

Sections 2 and 3 discuss and explain everything ^bout your diskettes from 
formatt/ng to storage. The novice to DOS should read through Sections 1 and 2 
betöre sitting down to work. This gives you an oppo •mtunity to become familiär with 
what you are to do. 


FOR THE NOVICE AND MORE 
EXPERIENCED USER 

Section 3 Starts your involvement with DOS 3, explshning how to identify your 
diskette files using filenames and filename extender s; this section also introduces 
you to Loading and Saving programs. 

Section 4 is the crossover point between the nevu 7 and more experienced user, 
and has a detailed description of each DOS Menu cs>ption and how to use it. Some 
of these options are only of interest to users familia. r with the Assembler Editor car- 
tridge and the hexadecimal number system. 


FOR THE MORE EXPERIENCED USER 

Section 5 reviews the BASIC commands used with DOS 3 and gives sample pro¬ 
grams showing the I/O commands in actual use. Esl ch command format is also 
followed by an example showing the types of data cgoing into each parameter. Sec¬ 
tion 6 contains further Information about ATARI Dis —c Drives and diskettes (which 
may be of interest to both levels of users), along wä ~th details about storing and 
retrieving data. The balance of the manual contai ns a glossary of terms and addi¬ 
tional Information for the advanced user such as: 

■ Memory Maps 

■ Errors 

■ Saving RAM space 





GETTING STARTED 
WITH DOS 3 


DOS (pronounced doss) is an acronym for Disk Opera t i ng System. Without a DOS, 
your ATARI Home Computer System cannot commun«ci^ate with your ATARI 
810™ or 1050™ Disk Drive. The DOS consists of com j—> rehensive utility routines 
that allow you to: 
m Store programs on diskette 

■ Retrieve programs from diskette 

■ Create and add to data files needed by programs 

■ Make copies of disk files 

■ Delete old files from a diskette 

■ Load and save binary files (for the advanced user) 

■ Move files to and from memory, the screen, diskett^e, and printer. 

■ Get help if you need it. 

If you have never used a DOS betöre, you will find t Bne ATARI DOS 3 simple to 
understand and easy to use. If you previously used ATARI DOS 2 you will find 

differences in ioading DOS 3 and changes to both the menu options and their com- 
mand parameters. These changes make DOS 3 more sdvantageous because you 
have more available user memory space and greater ~T Bexibility than with the 
9/24/79 Version of DOS 1 or DOS 2. 


SETTING UP 

To Start, you must attach your ATARI 810 Disk Drive e= 2 > r ATARI 1050 Disk Drive to 
your ATARI Home Computer System, making sure youj r Computer has at least 16K 
Random Access Memory (RAM). For complete instruo Itions on setting up your 
equipment, please refer to the operator’s manual shi|p goed with your System. The 
procedures for attaching the ATARI 1050 Disk Drive nd the ATARI 810 Disk Drive 
to your ATARI Home Computer System are contained) an the respective Disk Drive 
Operator’s Manual. 
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ADDING MORE DISK DRIVES 

S fhould you want to attach additional ATARI Disk Drives to your home Computer 
System, you do so by “daisy-chaining." In the back of each ATARI Disk Drive are 
two outlets (labeled I/O CONNECTORS); attach the I/O cord from your second disk 
drive to Drive 1. Then attach the other cord from Drive 1 to the Computer consoie. 



Fig ure 1-1 Disk Drive Configuration 


SETTING DRIVE CODES 

Loo>king at the back of your ATARI Disk Drive(s), you can see a hole with two tabs. 
The- white and black tabs must be moved on each drive according to that drive’s 
des ignation. Refer to Figure 1-2 for the proper drive code setting. 


Using a pen or a small screwdriver, set the 
switches in the window to match the patterns 
shown here for Drive 1, Drive 2, and so forth. 
You must always have one drive set as Drive 1. 


Figure 1-2. Drive Code Settings 
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LABELING YOUR DISK DRIVES 

Once you have properly set the drive Codes, label eachi cdisk drive with its appro- 
priate number so you do not make a mistake when disk drive functions. It is 

imperative that your Master or System Diskette ALWAV"£3 be placed in Disk Drive 1. 


INSERTING A DISKETTE 

Inserting a diskette into an ATARI Disk Drive is a simpü & . but very important pro- 
cedure. If the diskette is improperly positioned, it can göl use boot (starting-up) er- 
rors during DOS loading procedures, and can also damage the diskette. 

Turn on the disk drive(s), and wait for the BUSY light: tto go off. Insert the diskette 
as follows; 

1. Remove the diskette from its protective paper sleev^e- _ 

Caution: Hold the diskette ONLY by its black, sealecd envelope. DO NOT touch 
any exposed surfaces of the diskette, as this can irrugGair or destroy its read/write 
capabiiities. DO NOT hold the diskette by placing yo>a_ji r fingers through the 
center hole. DO NOT try to remove the^diskette from its black, sealed envelope. 

2. Hold the diskette so the labeled side is up, with the 1 ^bel toward you, and the ar- 
row on the label is pointing toward the disk drive do<o r (see Figure 1-3). Also, if 
your diskette has a write-protect notch, this should beon your left. Please note 
that your Master Diskette does not have a write-protect notch because it is 
automatically write-protected at the factory. 



Figure 1-3. Inserting a Diskette Into a Disk Drive 

3. Open the door to the disk drive and gently but firnm il , v' r slide in the diskette. 

4. Close the disk drive door. 
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WHAT IS A DÖS MENU? 

The DOS Menu is loaded into your Computer from your Master Diskette, which is 
always inserted into Disk Drive 1. The DOS Menu is similar to a restaurant menu; a 
selection of applications is presented to you on your television screen. You make' 
your selection by typing the appropriate code letter and pressing RETURN Your 
seleeted application is now available for use. 


HOW DO YOU CALL UP A DOS MENU? 


After you have your television set turned on, your Master Diskette inserted into the 
disk drive, and your disk drive turned on, you are ready to load DOS 3 into the 
Computer memory as follows: 

WITH A PROGRAMMING LANGUAGE CARTRIDGE INSTALLED OR WITH BUILT-IN 
BASIC 

When you turn your Computer on: 

1. The BUSY light on the disk drive goes on during the loading process. DO NOT 
attempt to remove the diskette while this light is on. If you have inserted the 
ATARI BASIC Cartridge or if your ATARI Computer has built-in BASIC , a READY 
prompt appears on the screen when DOS 3 is loaded. (If you have inserted the 
Assembler Editor Cartridge, the prompt is EDIT.) This completes the first part of 
the loading procedure. 

2. Type DOS and press RETURN. The DOS 3 menu displays on the screen (Figure 
1 - 4 ). This completes the second part of the loading procedure. 



Figure 1-4. The DOS 3 Menu 

With a cartridge present, the first part of the load brings in the FILE MANAGE¬ 
MENT SYSTEM (FMS) (from file FMS.SYS) and KEYBOARD COMMAND PRO¬ 
CESSOR (KCP) resident (from file KCP.SYS). The second part brings in the KCP 
overlay (from file KCPOVER.SYS), which displays the menu and process com- 
mands. 
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WITH NO CARTRIDGE INSTALLED 

When you turn your Computer on f DOS 3 loads entirely without user interaction, 

The BUSY light on the disk drive goes on during the loading p rocess. DO NOT 
attempt to remove the diskette while this light is on. The DOS menu is displayed 
automaticaüy when DOS 3 is loaded. 

After you make a code letter selection, a prompt message cd is plays on the 
screen requesting information from you. This capability makes it a “self-prompting” 
menu. The prompt message that appears most frequently resids: 

SELECTION? 

This means the System waits for you to do one of the followin g: 

■ Type in one of the letters or 

■ Press ESC, which redisplays the DOS menu. 
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WHATYOU SHOULD 
KNOW BEFORE 
USING DOS 3 



This section provides a set of definitions of terms used often On the descriptive sec- 
tions that follow. As specified in an earlier chapter, these terms are repeated in the 
glossary. It is important that these specific terms be somewhat familiär to you so 
that you can better understand how DOS 3 functions. Here are t he definitions: 


FORMAT 

To format (or to initialize) a disk means to prepare a disk for use. When you pur¬ 
chase a new blank disk, it has no data written on it. DOS 3 m ust be told to use the 
INIT (initialize) function selection of the main menu to format The disk. 

The INIT function uses a precise set of mechanica! steps to stop at a number of 
different positions on this blank diskette. Each of these positions is defined as a 
track. While at each of these positions, it writes data on the mag netic surface to 
separate each track into “sectors,“ 

A sector is an individually-accessible piece of the track. Each sector can be 
located later by the fite management System (known as FMS.SYS on your ATARI 
DOS 3 Master Diskette.) The FMS organizes these sectors into a. set of “blocks“ 
used to define the amount of space available and used on the di skette. Blocks are 
specified in the section on the File Index Option. 

Because this Information is magnetically recorded, exposin g tlhne disk to any kind 
of magnetic fieid may destroy your data. It is also important, as rmentioned earlier, 
to protect the recording surface from scratches or dirt that would make it more dif- 
ficult for the disk unit to “read.” 

For more information about how to format a disk, see the sectnon titled “How To 
Use The INIT Function.“ 


FILESPEC 

Filespec is a shorthand way of saying “file-specification.“ DOS 3 uses the name 
Filespec any time it wants you to specify the device, device number, and the name 
of the file you want DOS 3 to use. A “file“ is a grouping of data that is related in 
some manner. 


DEFAULT SPECIFICATIONS 

ATARI DOS 3 has a number of so-called “Default“ specificat Ions. This means that 
if you don’t choose any specific item, ATARI DOS 3 chooses an appropriate item 
“by default.“ 

In most cases, when a command question appears, there i s n othing eise on the 
command line except the question itself. 

If the default selection has not appeared yet on the command line, and if you 
might use the default selection, press RETURN once. This makes the default 
selection appear. If you wish to change the default, use your comnmand editing 



keys as noted in the seotion titled “Command Editing” to move the Cursor and 
change the response betöre again hitting RETURN. Note that for some commands, 
the default selection appears immediately along with the question. Therefore, look 
at the screen betöre hitting RETURN each time. (You may wish to make changes.) 

(nstead of accepting the default response, you may type your own response on 
the command line. Once there is a response on the command line, press RETURN 
for ATARI DOS 3 to accept that response. 

If you make a mistake in the command line betöre you press RETURN, you can 
use the command edit keys to make a correction. After you hit RETURN, you have 
to either ESC to the main menu again, or preferably just restart the current com¬ 
mand using the SHIFT/CLEAR or CTR/CLEAR key grouping. See the section titled 
‘'Command Editing” for more Information. 


WILDCARDS 

ATARI DOS 3 recognizes two "wild-cards" that you can Substitute for characters in 
a filename. Wild cards are represented by the special characters question mark (?) 
and asterisK (*) 

When DOS 3 encounters a wildcard character, it is told to find and use all 
filenames which match the "general description” of the filename you have 
specified this way. Each of the wildcards is treated as a “don’t care" item within 
the file name. The question mark is the singie-character wildcard. The asterisk is 
the multiple character wildcard. 

For example: 

PROG7-BAS 

The wildcard character (?) indicates that you don't care what the fifth letter is, 
just use any file in which the rest of the letters match. In this example, the names 
PROG1 .BAS, PROG2.BAS, and PROGZ.BAS match and those files would be used 
A name like PROG12.BAS would not match because the "2" would not have 
matched the blank in the original filespec. This is shown in the sample with the 
filespecs spread out to match the allowable maximum width shown in the section 
titled "FILESPEC" above; 

Wildcard example: PROG? ■ BAS 

(8 chars max.)--(3 chars max.) 

Actual file on disk PROG12 -BAS 

Notice that you do not need to specify the blank spaces. DOS 3 assumes that they 
are there if the left-hand part of the filename is less than 8 characters. In other 
words, the left hand side of the filename is "left-justified" in the field of 8 
characters. 

For example: 

PROG" 

The wildcard character (*) indicates that the filename is a match for any name in 
the file index that Starts with PROG and ends with anything eise, such as: 

PROGRAM PROGRESS PROG12 

The filespecs above do NOT match any of those given in the previous examples 
(PROG1.BAS, etc) because there was no "extension'’ specified. To match any of 
the file names with extensions, you would have had to specify: 

PROG*.* 

This combination means that any letters can follow the PROG part of the word, or 
any extension may be used (all blanks or anything eise).” 
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The asterisk, as a wildcard character, can appear a maximu m of once either on 
the left of the separating point (.) and once on the right. It alwsLys means “the rest 
of the characters, including the one at this Position.” 

Examples of the use of wildcards are used throughout this manual, particularly 
in the section on the File Index function. 

The following is a summary of the DOS menu options to Show whether they 
allow you to use wild cards in their Parameters. 


DOS MENU OPTION 

A. Access DOS 2 

C. Copy File 

D. Duplicate Disk 

E. Erase File 

F. File Index 

G. Go At Hex Address 

H. Help 

i. Init Disk 

L. Load 

M. Mem. Save 
P. Protect 

R. Rename 

S. Save 

T. To Cartridge 

U. Unprotect 

X. User-Defined 


WILD CARDS 

Yes 

Yes 

No 

Yes 

Yes 

No 

No 

No 

Yes 

No 

Yes 

Yes 

No 

No 

Yes 

No 


GETTING HELP 

There may come a time when you have accidentally entered t hie wrong Information 
or the wrong function. Or you may simply be unsure about what to do next. At this 
point you may either decide to Start another command or call the Help function. 

DOS 3 provides two different ways to exit from a command - 

The first way is the ESC (or escape) key. This immediately hi alts the current 
command if you are in the data entry screen for that command and returns you to 
the main DOS 3 menu. 

If, instead of returning to the main menu, you would like to get some helpful In¬ 
formation about the command, you can press the inverse video (ATARI) key or 
the HELP key. This performs slightly different functions depending on which of the 
functions you need Help with. 

For the functions: 

Init Disk, 

Duplicate, 

Copy/append, and 
Access DOS 2, 

the Help function is built into the utility routine itself. This mea ns that you can ask 
for Help, then use the ESC key to return to the data entry screen again. 

You may also switch back and forth as many times as you wdsh as you are 
entering the data by using the inverse Video key or the HELP Key to go to the Help 
screen for the function, and, as indicated on the Help screen itself, press the ESC 
key to return to the data entry screen. Each time you leave a f unction, anything 
you entered is lost. The ESC key, when pressed from the data entry screen, 
cancels the current command and returns you to the main menu. 

For all commands other than those mentioned in the previoos paragraph, press- 
ing the inverse Video key or the HELP key brings up a help so reen for the function 
being performed. This function’s help screen is called by loadi ng the normal Help 
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function. This cancels the current command and places you in control of the Help 
function. To reenter the main menu, ESCape from the Help function when you 
have read the desired screen, then reselect the original function. 


COMMAND EDITING 

DOS 3 provides, for most of the command options, a default data entry if no user 
entry has been selected. The default selection, if not already present on the com¬ 
mand line along with the command question, may be made to appear by pressing 
RETURN once. The keys listed in the following paragraphs result in the specific 
actions shown. If a key is pressed that the System does not recognize, a beep tone 
sounds to indicate a data error. Recheck your entry and try again. If you don’t 
want to use the default option, you can change the command line using the follow¬ 
ing keys: 

DELETE/BACKSP 

This key backspaces across each character, deleting as it goes. It allows you to 
retype whatever command you wish in its place. 

CTRL/RIGHT ARROW 

This key combination moves the Cursor to the right not deleting or otherwise 
changing the characters it passes through. This is useful for making a change to a 
single character on the command line. 

CTRL/LEFT ARROW 

This key combination moves the Cursor to the left not deleting or otherwise chang¬ 
ing the characters it passes through. This is useful for changing a single character 
to a different character in the command line. 

SHIFT/DELETE 

This key combination completely erases the current response on the command 
line, placing the Cursor at the first space immediately following the command ques¬ 
tion. 

CTRL/CLEAR 

SHIFT/CLEAR 

These key combinations completely erase all preceding sections of the command 
data entry and allow you to Start again. A case where this might be used is if you 
have noticed an error in a previous data entry line. DOS 3 does not allow the Cur¬ 
sor to be moved to a previous data entry for correction, but rather always keeps 
the Cursor operating on the line where the question is located. SHIFT/CLEAR 
means “restart the command.” 

ESCAPE KEY 

This key allows you to escape entirely from the command entry mode and returns 
control to the main DOS 3 menu. 

INVERSE VIDEO KEY, HELP KEY 

Either of these two keys, when used from the command line entry mode, tem- 
porairily exits this mode, and presentsyou with helpful Information about the com¬ 
mand. Note that in Order to use this function, on the disk in drive 1, the following 
files must be present: HELP.UTL and HELP.TXT. 


IDENTIFYING YOUR DISKETTE FILES 

Files are classified into two types: 
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PROGRAM FILES. 

These are sets of instructions that teil the Computer to p> er form specific tasks. 

DATA FILES. 

These usually contain the Information used by a prograrmn file, but not the instruc¬ 
tions. For instance, a permanent data file may be a nam e and address file capable 
of being updated at any time. 

Just as you call a person by name, you must call a file toy name when you want to 
access it. The fiiename on the diskette is part of the file specification (or filespec 
for short). Filespecs (Figure 2-1) have six key elements. Of you call a file by its 
wrong name, just like a person, it won’t answer; instead ^ an ERROR-170 appears 
on the television screen. 

The rules for filenames are: 

■ The maximum length of a fiiename is eight characterss. 

■ The only characters that can be used in a fiiename sl re the letters A through Z, 
and the numbers 0 through 9. 

■ The characters * and ? CANNOT be used as part of s name when establishing 
a fiiename. (See the section on Wildcards for explan^tion.) 


FILENAME EXTENDERS AND THEIF=t USE 

You can add a three-character extender to a fiiename to indicate the type of data 
in a file. You can use any legal combination of letters a nd numbers, for example: 

SYS system files 
BAS BASIC program files 
DAT data files 

MUS ATARI Music Composer™ files 
ASM assembly language files 
OBJ binary load files 
SRC source files 

LST files created by the LIST command 
SAV files created by the SAVE command 


“D1:ATARI 8 0 0. BAS” 


Device - 

Code 

Device - 

Number 

(optional) 

Required- 

Colon 

Fiiename- 

(up to 8 
characters) 

Period required — 
as Separator if 
extender is used. 

Extender - 

(optional) 

Includes 
0-3 characters 


Figure 2-1 Structure of a Filespec 
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If you try to use an extender that has more than three characters, DOS 3 ignores 
the additional character(s). The following summary illustrates both legal and illegal 
filenames, with an explanation of what makes a name illegal: 

CASHFLOW Legal name. 

ATARI.BAS Legal name. 

3ATARI.DAT Legal name. 

ATARI22.ASM Legal name. 

ATARI# Illegal name. 

AI234567.BA2 Legal name. 

B ATARI.LST Illegal name. No spaces allowed. 

FMS.SYS Reserved for DOS. 

FMSSYS Legal name. 

TEST1.123 Legal name. 


BOOT ERRORS 

When you Start your System, boot errors can occur for the following reasons 
(Figure 2-2): 

1 . The inserted diskette does not have DOS on it. 

2. The diskette was inserted wrong. 

3. The diskette has been scratched, warped, or marred. In this case, use another 
diskette. 

4. The diskette is a double-density diskette in an ATARI 810 Disk Drive. 



Figure 2-2 Boot Errors 
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The following conditions also cause a boot error, but no indi cation of it appears on 
the screen: 

1. The disk drive was turned on AFTER the Computer console was turned on. 

2. The disk drive is not properly connected to the Computer console. 

3. The power adapter plug has loosened from its wall socket. 

4. The power adapter plug has loosened from the disk drive PWR socket. 

5. The drive code setting is not correct. 

If you have checked and find none of these Problems, take the following steps: 

1. Insert the Master Diskette or a System Diskette into Drive 1 and reboot the 
System. 

2. Remove the Master Diskette and störe in a safe place. 

3. Reinsert the problem diskette and save any accessible files on another diskette 
using the process for copying files (see the COPY/APPEND Menu Option in Sec- 
tion 4). 

4. Then with the problem diskette in Drive 1, use the ERASE function to erase all 
the files. 

5. Try using the diskette again. If this falls, the diskette will have to be 
reformatted. 

Note: For the CX8111 ATARI 810 Formatted Diskette 3, this should be done 
ONLY AS A LAST RESORT to avoid losing the improved formatting. 

6. If reformatting fails, the diskette has bad sectors on it and should be discarded. 

SAVING, LOADING, AND RUNNING 
PROGRAMS 

After you have created your System Diskette and, if necessary, formatted a blank 
diskette, you are ready to write your own programs. When the power äs turned 
OFF on your Computer, you lose any program stored in mermory. With an ATARI 
Disk Drive, you have the means to störe and retrieve programs without having to 
retype them. You can use the following simple BASIC commands to störe and 
retrieve your programs. We have included a sample progrann for you to type into 
your Computer and a step-by-step procedure for saving it on a diskette and loading 
it back into the Computer. 

If You Have an ATARI 810 Disk Drive: 

1. Turn on the disk drive. 

2. Insert the System Diskette in Drive 1. 

3. Turn on the Computer console and television set. 

4. When the BUSY light goes off, remove the System Diskette, and insert a 
diskette that has been formatted. 

5. Type the program shown in the following example. 

6. Type SAVE “DdNTEREST.SAV” RETURN. 

7. When the BUSY light goes off and the READY prompt rmessage appears on 
the screen, the program you typed in is successfully saved on the diskette. 

8. Type NEW/RETURN to erase the program from RAM. 

Now to reload the program into memory: 

9. Type LOAD “D:INTEREST.SAV”/RETURN. 

10. When the READY prompt appears on the screen, you can now run the pro¬ 
gram by typing RUN/RETURN. 

11. You can also load and run your program by typing RUN 
“D: INTEREST.SAV’VRETURN. 

Note: Do not delete the Sample Interest program from your diskette; you will use it 
again in Section 5. 


100 REM *** INTEREST 

1 10 PRINT'TF YOU TYPE THE AMOUNT OF P 
RINCIPAL” 

1 20 PRINT'AND THE INTEREST RATE PER Y 
EAR, I WILL” 

1 30 PRINT'SHOW YOU HOW YOUR MONEY GRO 
WS, YEAR BY” 

1 40 PRINT“YEAR. TO STOP ME, PRESS THE 
BREAK KEY.” 

150 PRINT 

160 PRINT‘‘PRINCIPAL”; 

165 INPUT P 

170 PRINT'INTEREST RATE”; 

175 INPUT R 
1 80 LET N = 1 
190 PRINT 

200 LET A = P*(1 -t- R/lOO) N 
210 PRINT-YEAR = “;N 
220 PRINT“AMOUNT = ”A 
230 LET N = N + 1 
240 GO TO 190 
READY 


THE DOS 3 MENU SELECTIONS 

The following paragraphs explain the various selections you can make from the 
DOS 3 Main Menu. I n each paragraph, there is a briet explanation of what each of 
the functions does. 

Please do not try to use these options until you understand them thoroughly. 
There is a separate section in this manual to explain each of them. 

File Index 

Selecting this item allows you to view an index of the files on a diskette or simply 
to find out if a file of a particular name is on the disk with which you are working 
See the section titled "How to use the File Index Function” for a detailed 
description. 

To Cartridge 

This selection directs DOS 3 to give control to a cartridge you have installed in the 
left-hand Slot of your ATARI 800™ or in the cartridge slot of your ATARI 400™ or 
1200XL . For more information about what happens after this selection is chosen 
see the section titlecf ‘‘How to use the To-Cartridge Function.” 

Copy/Append 

Selecting this function allows you to make copies of your program or data files 
The copies may be made using either a one or a multiple disk System, or, if it is a 
“text” file, the copy may be directed to yourTelevision screen or your printer See 
the section titled “EHow to use the Copy/Append Function” for more information. 

Duplicate 

Selecting this function allows you to make a complete copy of an unprotected 
ATARI program disk. It includes the capability to initialize a disk (see below for Init 
Option). It performs a block-by-block copy from one disk to another, using either a 
single-disk or a multi-disk System. For more information, see the section titled 
“ How to use the Duplicate Function.” 


Init Disk 

Selecting this function allows you to initialize, or prepare a disk for use, It is also 
known by the name “Format” because it writes a certain pattern on a disk that 
allows it to read and write data onto it later. For more details about using this 
Option, as well as a description of what Format really means, see the section titled 
“How to use the Init Function." 

Access DOS 2 

For those of you who have purchased or developed Software w ritten to run under 
ATARI DOS 2, this function allows you to use your disk drive to read and convert 
such programs and data so they run under DOS 3. For complete Information show- 
ing how to run the conversion, see the section titled “How to use the Access DOS 
2 Function.” 

Load 

This function allows you to put back into main memory any dato. you have saved 
with the Save function. For more details, see the section titled 6 ‘How to use the 
Load Function." 

Save 

This function allows you to save the contents of specified memory locations on 
disk. It is normally used with machine language programs. See thie section titled 
“How to use the Save Function” for more details. 

Erase 

This Option allows you to delete one or more files from a diskette. It is normally 
used to make room for data on the diskette when that old data is no longer 
needed. Once a file has been erased, its data no longer can be recovered. For 
more information, see the section titled “How to use the Erase Function.” 

Rename 

This function allows you to change the name of a file currently in the File Index of 
a diskette. It is often used to simply make a name more meaninQful than that used 
to put it on the disk in the first place. More Information about this function is shown 
in the section titled “How to use the Rename Function.“ 

Protect 

This function allows you to teil DOS 3 that a particular file should be protected. 

This means that DOS 3 should mark the file name in a special way to prevent it 
from being erased accidently. In fact, if you try to erase a proteoted file using the 
DOS 3 Erase command, it reports an error. For more information about this Option, 
see the section titled “How to use the Protect Function.“ 

Un protect 

This function is the reverse of the one above. It removes the protection from a 
specified file so that it can be erased without causing an error report. See the sec¬ 
tion titled “How to use the Unprotect Function.“ 

Mem.Save 

This function allows you to create a file on the diskette to störe the contents of 
memory while part of DOS 3 is being used. It is often used by the advanced user 
who goes from a programming language to DOS and back often during program 
development. It is used to save the program being developed in memory when 
DOS 3 is active. It is restored to that memory area DOS 3 had temporarily used 
when the user returns to the programming language. For detailed information on 
Mem.Sav, see the section titled “How to use the Mem.Sav Function.“ 
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Go at Hex Addr 

This functi on is used by the machine tanguage user to Start the execution of a pro¬ 
gram that bas already been placed into the memory system. !t requires knowledge 
of machine language programming. For more Information, see the section titled 
“How to use the Go-at-Hex-Addr Function.” 

X-User-Def i ned 

This setection allows you to define the name of a machine language program, sav- 
ed on the d Iskette using the Save Option, to load and run. For details about this 
selection, see the section titled “How to use the X-User-Defined Function.” 

Help 

This optiom literally can Help you learn about the Operation of DOS 3. Ali of the In¬ 
formation you need about how to operate DOS 3 is contained in this manual. If you 
need aquick reminder about some of the possible Option choices, the Help func- 
tion may b<e used to get that Information. For more data on the Help Function, see 
the section titled “How to Get Help. T, Note that in some of the selections, it is 
possible to obtain Help while you are entering data for the control of the function. 
These detaiif's are specified in the section referenced above. 


WHAT ELSE IS ON THE MAIN MENU? 

There is a solid white line shown on the main DOS 3 menu. This is the error or 
results repo rting line. It normally remains a solid color. When errors occur, this line 
specifies the error number and a message which should help you determine what 
to do next. Düring certain functions, such as protect and unprotect, this line is also 
used to report function progress. 

A list of the possible errors and some suggestions for probable causes are con¬ 
tained in 3 separate appendix E, titled DOS 3 ERROR MESSAGES. 

The finaß Item on this main menu is “Selection?”. DOS 3 is asking you to select 
an Option f rom the menu. Betöre you select, make certain you are already familiär 
with the terrms shown in the section titled “ What You Should Know Before Using 
DOS 3.” Then, for each Option, turn to the section where that Option is explained to 
show you exactly how it is to be used. 
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DISKETTES 


3 


THE MASTER DISKETTE 

The Master Diskette contains the disk operating System programs. These programs 
include all the System file management and utility routines necessary to make your 
disk drive function with your ATARI Home Computer System. Without a disk 
operating System, you cannot access the disk drive. 

Each Master Diskette contains the following files: 

FMS.SYS File 

FMS.SYS is a file containing the File Management System. FMS.SYS contains the 
subfunctions that are provided by the FMS: ERASE FILE, RENAN/IE FILE, PROTECT 
FILE, UNPROTECT FILE, and LOAD. 

KCP.SYS File, KCPOVER.SYS File 

This combination contains the DOS Menu and DOS subfunctions NOT provided by 
the FMS. These files make up the Keyboard Command Processor (KCP). Whenever 
you want to see the DOS Menu or perform these DOS subfunctions (SAVE, GO AT 
HEX ADDRESS, TO CARTRIDGE, COPY FILE, INIT DISK, DUPLICATE DISK and 
ACCESS DOS 2), you must load the KCPOVER.SYS file into RAM by typing DOS 
and pressing RETURN. 

Note: Normally when you bring the KCPOVER.SYS file into RAM, it writes over 
data in the lower program area occupied by BASIC or assembly language pro¬ 
grams. However, when you create a MEM.SAV file (see section on MEM.SAV) on 
your diskette, DOS saves any data in RAM to diskette betöre loading 
KCPOVER.SYS When you are finished using the KCP functions, MEM.SAV allows 
you to reload your program aütomatically. 

HANDLERS.SYS File 

This file is used to poll (check) the peripheral units (if any) attached to your ATARI 
Home Computer System and to run machine code programs (see Section 4 of this 
manual for more detail on AUTORUN.SYS). If this file is on the drive 1 diskette dur- 
ing boot up, it is loaded and run aütomatically. 

HELP.UTL—The HELP utility 

HELP.TXT— Text information displayed by the HELP utility 
INIT.UTL—The INIT Disk utility 
CONVERT.UTL—The ACCESS DOS 2 utility 
DUPDISK.UTL—The DUPLICATE utility 
COPY.UTL—The COPY/APPEND utility 


ATARI FORMATTED DISKETTES II 

in addition to the Master Diskette 3 (CX8104), your ATARI Disk Drive comes with 
an ATARI Formatted Diskette 3 (CX8111). Although this diskette has no files or pro¬ 
gram data om it, it has been preformatted at the factory. Preformatting means the 
diskette was ciivided into tracks and sectors betöre packaging (Figure 3-1) so that it 
has an impro\/ed sector layout. This improved sector layout makes it possible for 
you to störe and retrieve information more rapidly than is possibie with diskettes 
formatted on your ATARI Disk Drive. This“empty M diskette is provided so you ca n 
make a backup copy of your Master Diskette. This backup copy, cailed a System 
Diskette, is thne one you actualiy work with, ensuring the safety of your original 
Master Diskette (see Making a System Diskette). 


Formatted Diskette 


Sector (section of track) 
Track (one revol ution) 


Write-Protect Notch 


Timing Hole 


Read-Write Area 



Figure 3-1 A F r ormatted Diskette 


lf, at any time, you decide to erase the files from a preformatted diskette, use the 
DOS Menu selection E, ERASE FILES. This saves the improved sector layout that 
allows the d iskette to run faster. Note that if you reformat the diskette for any 
reason (pertnaps to test for possible bad sectors), it no longer has the improved 
sector layout. 

Note: You can also use blank diskettes that have not been preformatted at the 
factory with the ATARI Disk Drive. You can format these diskettes yourself using 
the 1 NIT me nu Option before duplicate disk or störe programs on them (see How to 
Format a Diskette). However, you do not have the advantage of the improved 
speed of the preformatted diskettes. 
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HOW TO FORMAT A DISKETTE 

You need to formst any blank diskette betöre you can write on it. Formatting 
organizes a diskette so DOS 3 knows where information is loceated. Unlike a 
Phonograph record that has visible spiraling grooves imprinted onto it, the diskette 
has magnetically encoded tracks that are not visible. 

Once you have formatted a diskette, it contains 40 concentrn o tracks, which are 
divided into 18 (26 for double density) pie-shaped wedges calle«cä sectors. You 
ascertain the storage capacity by multiplying the number of tra_cks (40) by the 
number of sectors per track (18), which gives you 720 sectors. Each sector can 
störe 128 bytes of data. These sectors are, in turn, organized toy the FMS into 
blocks of 8 sectors each. Therefore a single-density, freshly for-matted disk con¬ 
tains 720/8 = 90 blocks. A double-density formatted diskette for the 1050 contains 
1040 sectors or 130 blocks. 

Three blocks are used for booting the System and for the files index. As a result, 
you actually have a total of 87 blocks to which you may write cdata. The ATARI 
1050, in double-density mode, has 127 blocks available. 

To format a diskette, you must use the 1, INIT DISK Option o n the DOS menu. If 
you are using an ATARI 810 Disk Drive as Drive 1, see instrucdrions below. If you 
are using an ATARI 1050 Disk Drive as Drive 1, the same instr uctions are valid 
because you are using the 810 single-density format. 

USING THE ATARI 810 DISK DRIVE: 

1 . Turn the disk drive on. Wait for the BUSY light to go off. 

2. Make sure the switch on the back of the disk drive is set to No. 1 (refer to 
Figure 1-2 for drive code settings). 

3 . Insert the ATARI 810 Master Diskette and close the drive sdoor. 

4. Tum the Computer console on. DOS loads into the Computer memory. 

5. When the READY prompt appears (if you have inserted tho e ATARI BASIC car- 
tridge or your Computer has built-in BASIC), type DOS ancd press RETURN. After 
a few seconds the DOS Menu appears on the screen. (If mo cartridge is in¬ 
serted, the DOS Menu appears on the screen automatical ly.) 

6 . Type I for the (NIT DISK Option and press RETURN. 

7. When the prompt message Format disk in drive (1-8)? appears, remove the 
Master Diskette from the disk drive and insert a BLANK d iskette. Close the 
door, and press RETURN twice. The first time you press ETRETURN, a 1 
appears. This is called the default drive selection. The secoond time you press 
RETURN, you indicate to DOS 3 that drive 1 is to be usecd . CAUTION - NEVER 
FORMAT YOUR MASTER DISKETTE! 

8 . The next prompt says: 

Format type? 

1 for single density 

2 for double density ? 

Press RETURN twice. The first RETURN results in a 1 : the second 
RETURN indicates to the System that you intend to use cd rive 1, the default 
drive. 

9. The next prompt says: 

Write FMS.SYS file#(Y/N)? 

Type Y RETURN, then press RETURN again. 

This sequence indicates to DOS 3 that you are making a System diskette. 

10. The final prompt used for this example is: 

Modify FMS parameters (Y/N)? 

Press RETURN twice to indicate to DOS 3 that a Standard file manager is 
required. 
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1 1. At this point DOS 3 displays the Parameters selected for this function, next it 
displays: 

Press SHIFT-CLEAR to select different initial values or... 

Insert diskette in drive #1 and press RETURN to initialize. 

1 2. CAUTION - FORMAT ERASES ALL DATA ON THE DISK BEING FORMATTED. 
When you press RETURN, the BUSY light comes on and the System formats 
the diskette. 

13. When DOS 3 has completed its task, it prints: 

Initialization completed. 

Press RETURN to init next diskette. 

Press ESC to return to DOS. 

The diskette is now ready to use. Follow any of the specified instructions to 
proceed. 

If you have two or more ATARI 810 Disk Drives, you can format a blank diskette 
on any drive. However, you must know the drive code setting of the drive you use, 
so you can respond to the prompt: 

Format disk in drive(l-ö)? 


(VIAKING A SYSTEM DISKETTE 

The first disk Operation you should perform is to duplicate your Master Diskette. 
This provides a backup in case the diskette you are using is damaged. For conve- 
nience, the duplicate of your master diskette is referred to as the System Diskette 
(working copy), and is the one you would normally use to load DOS 3 into RAM. 


WRITE-PROTECTING YOUR DISKETTES 

Write-protecting is simpiy a method of preventing you from inadvertently writing 
over valuable information you may not want to lose from a diskette. 

You may notice that the DOS 3 Master Diskette has no notch on the left side of 
the diskette jacket so it is impossible to write files on it; therefore, it is already 
write-protected. Blank and preformatted diskettes do have the notches on the left 
side of the diskette jacket enabling you to write to the diskette. 

Normally, you would not write-protect a System Diskette, as this defeats the pur- 
pose of the MEM.SAV file, preventing you from writing the RAM-resident program 
to the diskette when necessary. For this reason, you may wish to put the files you 
want to save on another diskette, which you can write-protect. 


HOW TO WRITE-PROTECT VALUABLE 
DISKETTES 

A sheet of large file Identification labels and a second sheet of small adhesive 
write-protect tabs are included in each box of ATARI diskettes. 

Write-protecting is accomplished by simpiy removing an adhesive write-protect 
tab from the sheet and folding it over the notch on the edge of the diskette (Figure 
3-2). 
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Figure 3-2. Write-Protecting a Diskette 


lf you try writing to a write-protected diskette, an ERROR-144 message is displayed 
on the screen. 


LABELING DISKETTES 

Use the self-adhesive labels to identify the data on each diskette. Write on the 
label first to avoid damaging the diskette, and then attach these Sabels in the upper 
right corner of the diskette envelope. 


SINGLE-DENSITY AND DOUBLE-DENSITY 
DISKETTE RECORDING 

The principal difference between the ATARI 810 Disk Drive and the ATARI 1050 
Disk Drive is the way the data is encoded for storage on diskettes. Both the ATARI 
810 and the 1050 drives störe data on the diskettes in 128-byte sectors. In addi- 
tion, the 1050 can read or write 810 compatible (720 sectors) diskettes or it can 
write in double-density mode (1040 sectors). Note however, that although the 1050 
can read single-density 810 diskettes, the 810 cannot read double-density 1050 
diskettes. Therefore, if compatibility is required between the 810 and the 1050, you 
should use the 1050 in single-density mode. 
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HOW TO STORE DISKETTES 

Since your diskettes are flexible, they are subject to damage. The following sugges- 
tions are to keep your diskettes in good condition: 

■ ALWAYS keep the diskettes in their protective paper sleeves when not in use. 

■ Store them vertically as you would properly störe records; do not stack them 
one on top of another. 

■ Store the diskettes AT LEAST 1 2 inches from your television set or any other 
possible source of magnetic fields. 

■ Store the diskettes away from any direct source of heat. 

You r diskettes are an important and valuable part of your ATARI Computer 
System and, with proper care, should provide you many hours of dependable use 
and enjoyment. 
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SELECTING AND USING 
DOS 3 FUNCTIONS 



HOW THIS CHAPTER IS ORGANIZED 

ATARI DOS 3 provides many features that should make it easy for thn e first-time 
user to get acquainted with and effectively use the System. 

This manual begins with a section showing exactly how to get star - ted. This is 
followed by a section on words the user should be familiär with betone proceeding 
to read the rest of the manual. These terms are also included in the ^lossary at the 
end of the manual, however it is essential that those covered in this *early chapter 
be known to allow the user to understand the other parts of the man ojal. 

The rest of the manual is organized to allow an easy introduction "ito the first-time 
user. It is written as a semi-tutorial to ATARI DOS 3 in that for each ^command that 
DOS 3 can execute, the first thing encountered is always the most asic definition 
of the task that DOS 3 can perform. This is followed, in each case, tr^y the exact, 
keystroke-for-keystroke command sequence that is needed to do the?- most common 
of the tasks that this command can perform. 

Following the description of the most often used command sequer-nce is the ex- 
planation of other features that are built into this command sequenc «. The first- 
time user may simply skip on to the next major section at this point ^ach time, if 
one is simply trying to get a feel for “what is DOS 3.” 


HOW TO USE THE ACCESS DOS 2 FUNCTI ON 

This function is selected from the main DOS 3 menu by the letter A. It is used to 
convert existing files written for use with ATARI DOS 2 so that they scan be used 
with DOS 3. 

This conversion is necessary because the file structure of DOS 2 is different 
from that of DOS 3. DOS 3 cannot, without conversion, read the File* Index or any 
of the files of a DOS 2 diskette. After the conversion is made, all file* s can be used 
normally with DOS 3 loaded. 

On selection of the A Option of the DOS 3 menu, the Computer reooorts, on the 
DOS 3 menu screen, the following message: 

Loading D:CONVERT.UTL... 

This means that, to run this function, this program must be preser rt on the 
diskette inserted into disk drive number 1. After the file has been losided, the 
screen clears, and another screen appears. The options on the scre^ en show the 
default selections. In other words, as each question appears on the screen, the 
RETURN key is pressed twice ... once to make the default selectiom appear, and 
the second time to accept the default. 

The first question the Computer asks is 
Source drive number? 

The default is 1. This is the DOS 2 diskette that you wish to read and converted 
to DOS 3 format. 
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The second question the Computer asks is 

DOS 2 fiiename? 

The default is *.* which means ALL files on that disk. This Utility can convert 
one, or only selected files. See the rules on wildcards in the section titled M What 
You Should Know Betöre Using DOS 3” tor more Information about file 
specifications. 

The thfird question is 
Destination drive number? 

The default is 1 (a single drive conversion is ok). The files that match the source 
filespec eire read from the source drive in DOS 2 formst, and rewritten to the 
destination drive using DOS 3 format. If you have a two-drive System, it is most ef- 
ficient to specify one drive as the source and the other as the destination. Offner- 
wise, it is necessary to swap diskettes in and out of the single drive until the func- 
tion is completed. 

The fourth question is 
DOS 3 filename? 

The default is *.* which means make the file names the same on the DOS 3 
destination disk as they were on the DOS 2 source disk. The filename contents (8 
letters, plus 3 letter extensions) are the same from DOS 2 to DOS 3, so no mean- 
ing is lost in the translation. 

After the questions have been answered, and you have pressed RETURN to 
enter the final response, the screen indicates either: 

Insert source disk. Press RETURN 

(if a single disk drive is being used) 
or: 

Insert source disk, 

Insert destination disk. Press RETURN 

(if two disk units are specified). 

if a singie drive is used, the prompt alternates between: 

Insert source disk 

and 

Insert destination disk 

Continue ailternating until the conversion process is complete. 

To avoicJ any possible errors be certain that the source diskette has been write- 
protected betöre you Start. 

GETTING HELP 

This function has a built-in Help feature. You can ask for help at any time during 
the comnoand entry phase by pressing the inverse Video (ATARI) key or the HELP 
key from the command entry screen. When you have read the Help screens and 
wish to return to the data entry screen, press the ESC key. You may go back and 
forth to this Help screen as often as you like during the command entry phase by 
pressing i nverse Video (ATARI) or HELP to get help, and ESC to go back to the 
data entry screen. Note that when you reenter the ACCESS DOS 2 Function data 
screen from the Help function, you must reenter any data. 

Be caref ul that you do not become confused on this function because the ESC 
key, if pressed from the command entry level, escapes from the Access DOS 2 
function and returns to the main DOS 3 menu. 

The Access DOS 2 help screen Is shown in the following typed example. It is 
typed exactly as it appears on the screen. It is the same screen you see if you 
select the Help function directly from the DOS 3 Main Menu. It summarizes the 
Information given above. 
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Access DOS 2 Help Screen 1 of 3 

1. Press A to access a DOS 2-formatted disk and convert one or more files onto 
a DOS 3-formatted disk. PRESS A WITH DOS DISK IN DRIVE 1- 

2. Source drive number? Enter no. of drive with DOS 2 disk. 

3. DOS 2 filespec? Wildcards are OK. 

You cannot get a file index from the DOS 2 disk. But you can see the name of 
each file on the disk, if you 
a seiect Dn:*.* as filespec, and 
b use RETURN response in STEP 7. 

Access DOS 2 Help Screen 2 of 3 

4. Destination drive number? Enter no. of drive with DOS 3 disk. Vou can use the 
same or another drive. 

5. DOS 3 filespec? You can use new or the same filenames. Wildcards can also 
be used. 

Access DOS 2 Help Screen 3 of 3 

6. Are source and destination the same disk (Y/N)? Press Y to convert files on 
same disk. Press N to convert files on diferent disks. (See screen.) 

7. Convert all specified files (Y/N)? Press Y to convert files automatically. Press 
N or RETURN to convert files one at a time. DOS gives you a Y7N Option on 
each. 

Remember: Using RETURN on Step 7 with a Source Filespec of Dn:*.* causes 
DOS to show you the names of all files on the DOS 2 disk. 

Press P to print this screen 
Press RETURN for more help 

If this help screen has been accessed through the main menu help function, the 
last line on the screen reads: 

Press ESC for help menu. 

If this help screen has been accessed while this Utility was loaded, the last line 
reads: 

Press ESC for Access DOS 2 screen. 


HOW TO USE THE COPY/APPEND FUNCTION 

This function is accessed from the main DOS 3 menu using the C selection. It is 
used to make copies of files that you specify from one disk to another. It may be 
used with a single disk drive or with two drives. It may also be used to “append,” 
that is, to add onto an existing fiie. This is, however, a more advanced function and 
is not likely to be used by the first-time user. 

FOR THE FIRST-TIME USER 

When you seiect function C, DOS 3 compietes the wording for you: 

Selection? Copy/Append 

and highlights this selection on the main menu. 

It then specifies, at the bottom of the main menu: 

Loading D:COPY.UTL ... 

This means that this file name must be on the disk in drive 1 in order to be able to 
run this function. After the copy utility file, as it is called, is loaded, the screen is 
cieared and the copy utility screen is displayed. The first question asked is: 

Append? N 

In this case, the default reply already appears with the question. Press RETURN 
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again to ask the machine to accept a no-append reply. (See below for more ex- 
planat ion about append). 

No \rv the next question is: 

Sourc« device? 

Assuming that you are doing your first copy from drive number 1, press RETURN 
to make the default response appear, as follows: 

Sourc« device? Dl: 

Press RETURN to accept the default. The next question DOS 3 asks is: 

Sourc® filename? 

If you do not know what a filename is, please refer to this subject in the section 
"What You Should Know Betöre Using DOS 3.” In this filename, you may use the 
wildcsards if you wish to copy more than one file, or you may specify a single file 
name. Note that this filename does NOT include the source device since it has 
alreacüy been specified. An example filename would be: 

Source Filename? COPY.UTL 

If, instead of copying just one file, you wanted to copy all files to a new disk, it per- 
forms the copy function the same as the Duplicate function if you just press 
RETU RN instead of entering any file name. In this case, the default appears as: 

*.* whn ich means that all files are to be copied from the source disk to the destina- 
tion df sk. The main differences between Copy and Duplicate are as follows: 

Duplicate gives you no choice of which files to copy, but it copies all files on the 
source disk. “Files” are not actually copies, but rather Segments of the disk in 
which files are stored. What this means is that disk swapping in a single-drive 
System is less frequent than it might be if you had used copy instead. The typical 
disk d uplicate function, if there is 48K of RAM to use, would take 3-4 swaps of the 
source and destination disks in that single drive. The equivalent copy function, 
where all files are to be moved, requires one swap for EACH file in the file Index! 
Theredore, if you wish to duplicate all files, the Duplicate function involves less 
work for you. 

Dupolicate also formats a disk for you if you have not already done so, all in one 
operadüon. 

Copoy allows you to specify which files are to be copied. If single files are 
specif ied, you may also change the name of the copy. For the copy function, 
however, you must have a formatted diskette in the destination drive. 

The n*e>xt question DOS 3 asks is: 

Destination device? 

If you have a single-drive System, press RETURN to make the default appear ... 
Destination device? Dl : If you have a two drive System, you may press RETURN 
to make the default appear, then use the command edit functions (CTRL + left ar- 
row) to» move the Cursor left, onto the 1, and type a 2 over it. 

Then poress RETURN to ask DOS 3 to accept the input. 

Now DOS 3 asks: 

Destination filename? 

The normal response is to ask DOS 3 to give the same name to each of the copies 
on the destination disk as were given to the files on the source. Therefore, it is nor¬ 
mal ad this point to press RETURN to make the default appear: 

Destination Filename? *.* 

This means give all of the destination files the same name as each source file it 
copies. 
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Press RETURN to accept this default. 

Next, if the source and destination are the same device, DOS 3 asks: 

Are source and destination the same diskette (Y/N)? 

If you are copying files from one disk to another, answer NO tfhis question. If you 
are copying files onto the same disk, answer YES. 

Now the System gives instructions, as; 

Insert source disk, press RETURN (if single) 
or 

Insert source disk. 

Insert destination disk, press RETURN. 

(if a dual-disk System) 

If you have a single disk System, after it reads the file (or each file if you specify 
more than one), it asks: 

Insert destination disk, press RETURN 

The System then informs you about the progress of the copy work, by the 
message: 

Copying D1:COPY.UTL to D1:COPY.UTL 

or if you have a two drive System, it says: 

Copying D1:COPY.UTL 

to D2:COPY.UTL (or some other name if you have changed the destination name). 

IF WILDCARDS ARE SPECIFIED 

If you use any wildcards in specifying the filename for the sou ree disk, the copy 
utility asks: 

Copy all specified files (Y/N)? N 

Note that the default response N (no) is already in place. 

At this point, if you press RETURN for each matching file name on the source 
diskette (a *.* wildcard matches all of them), the copy function asks: 

Copy D1:FMS.SYS to 
D1:FMS.SYS (Y/N)? N 

In this case, the default reply is always No. For each file you wish to copy, youi 
have to press Y, for Yes, then press RETURN. 

If you are already sure you want to copy all files with a spe cific filespec or 
filespec with wildcards, then it is most efficient for you to respond Yes to the Ques¬ 
tion: 

Copy all specified files (Y/N)? Y 

Note that you should change the N to a Y before pressing RETURN. Then the 
System copies all specified files without asking you about each one as it finds 
them. 

After all of the matching file names have been copied from one drive to the 
other, it ends with the message: 

X file(s) copied 

In this case X represents the total number of names on the source diskette that 
matched the source filespec and were copied onto the destination diskette. In addi- 
tion, if any wildcards had been used, then the message No more (filespec) files 
found, will appear. 

This indicates that all filespecs matching the one specified have been found and 
copied. 
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The final question is: 

Do you have more files to append or copy (Y/N) ? Y 

In this case the default response is already printed with the question. If you wish to 
copy more, or otherwise use the copy utility program, press RETURN. If you 
change the Y to N, then press RETURN here, you RETURN to the main DOS 3 
menu. 

IF YOU MAKE MISTAKES IN DATA ENTRY 

If you notice a mistake in a comrnand line before you press RETURN, you can edit 
the comrnand using the comrnand line edit functions mentioned in the chapter 
titled “What You Should Know Before Using DOS 3.” 

If you notice a mistake in a comrnand line after you have already pressed 
RETURN, and wish to go back and Start the entry over, the key combinations 
SHIFT/CLEAR or CTRL/CLEAR restart the comrnand entry at the first line again. 

HOW TO GET HELP 

This utility has a built-in Help function, accessed by pressing the inverse Video 
(ATARI) key or the HELP key. You can access this help feature to read some 
useful 'Information about this function if you cannot remember what to enter at a 
particular point. To return from Help, to continue your data entry on the copy 
screen, press the ESC key. 

You may go back and forth between the data entry screen and the Help screen 
as often as you wish, pressing the inverse Video (ATARI) or HELP key to get help 
and the ESC key to return to data entry. However, as with the duplicate function, 
be careful not to become confused. An ESC key, if hit from the copy entry screen, 
escapes from that function and returns you to the main DOS menu. Note, however, 
that when you reenter the Copy function data screen from the Help function, you 
must reenter any data. Data is not saved when you ask for help. A copy of the help 
screens for this function is contained at the end of this section. They summarize 
the information contained in the section. 

FOR THE ADVANCED USER 

The Copy function allows you to copy files from any legal source device to any 
legal destination device. If the device is not a disk, then the source or destination 
filespec question will not appear. This means that you may, if you desire, use this 
utility to copy files to the screen, to the printer, or any other device for which a 
handler is present. 

APPENDING FILES 

The Append function allows you add onto the end of an existing file. All of the 
questions are the same as those already asked during the function, however, in- 
stead of a separate file being generated for the copy, the new data is simply 
"tacked onto the end’ ’ of an existing file. Note that this file must exist or the ap¬ 
pend function generates an error (file not found). 

THE COPY FUNCTION HELP SCREENS 

These screens are the same ones you see whether you access them from the 
HELP function of the main DOS 3 menu or ask for Help during the comrnand entry 
mode. They are as follows: 

Copy/Append Help Screen 1 of 4 

1. Press C to COPY or APPEND files. COPYing creates a duplicate file on the 
same or another disk. APPENDing copies a file and joins it to another file. 
PRESS C WITH DOS DISK IN DRIVE 1. 

Note: Use COPY to write DOS files onto other diskettes as needed. 
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2. Append (Y/N)? Press Y to append (join) two or more files. If you press N or 
RETURN, DOS will copy without appending. 

You can COPY or APPEND using one or two disks and one or two drives. 
Copy/Append Help Screen 2 of 4 

3. Source device? Specify device with source file(s). Dn: = drivo no., E: = screen, 
C:=cassette. 

4. Source filename? Enter filename. Wildcards can be used. 

5. Destination device? Specify device to receive file(s) or witti file(s) to be ap- 
pended. Dn:=drive no. E: = screen, P: = printer. 

Copy/Append Help Screen 3 of 4 

6. Destination filename? Wildcards can be used. If appending, use existing 
name. If copying onto same disk, choose new filename. 

Note: DOS does not allow duplicate filenames on a single diskette. 

Copy/Append Help Screen 4 of 4 

7. Are source and destination the same diskette (Y/N)? Press Y to copy/append 
files on the same disk. Press N to copy/append files on different disks. 

8. Copy/Append all specified files (Y/N)? Press Y to copy/append all files in 
source filename. Press N or RETURN to copy/append files one at a time. 

9. When processing files one by one, DOS gives you a Y/N osption for each. 

Press P to print this screen 
Press RETURN for more help 

If this help screen has been accessed through the main menu help function, 
then the last line on the screen reads: 

Press ESC for help menu 

If this help screen has been accessed while this utility has been loaded, then the 
last line reads: 

Press ESC for Copy screen 

HOWTO USE THE DUPLICATE FUNCTION 

This function is used to duplicate a complete disk. The disk from which the copy is 
to be made must be one which has been formatted using DOS 3. It is called from 
the main DOS 3 menu using the D selection. On selecting D, the System command 
line specifies: 

Selection? Duplicate 

Then this same word is highiighted in the menu selection area. It places the follow- 
ing line at the bottom of the menu screen: 

Loading D:DUPDISK.UTL ... 

This means that your diskette must have this file name on it in drive 1 in order to 
execute the duplicate disk function. Now the screen ciears, and presents the 
Duplicate information screen. Next the System asks the question: 

Source drive number? 

For the first-time user making a DOS 3 backup (or a user maki ng a backup of any 
kind of disk) 

1. If you have a single drive System, press RETURN 3 times. This results in the 
foliowing display: 

Source drive number? 1 
Destination drive number? 1 
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2. If you have a two drive System, and you wish to duplicate from drive 1 to drive 
2, then follow instruction number 1 above. Then press the Backspace key and 
type over the 1 at the Destination Unit question, to make it a 2. 

3. Now press RETURN again. 

4. The Computer now gives one of two possible responses, depending on whether 
a single or a dual drive System was indicated. For example, it may say either: 

Insert source disk in drive 1 
Insert destination disk in drive 2 
Press RETURN 

(if you have a two-drive System) 
or 

Insert source disk in drive 1 
Press RETURN 

5. Be sure you r source diskette has been write-protected. This means that the 
notch along the side of the diskette has been covered by a write-protect tab 
Your ATARI DOS 3 Master Diskette is formed without a notch, so it is already 
write-protected. 

6. From here onward, you may follow the instructions that appear on the screen 
about handling of the source and destination disks. 

Note that if you are using a two drive System, it is not necessary to handle the 
disks until the duplication is completed. Use of a single drive System requires that 
the source disk be inserted to read the source materials into memory, then the 
destination disk has to be inserted to write these materials onto it. 

As the copy progresses, the Computer teils you about the progress, showing how 
many blocks remain to be read and how many remain to be written. 

HOW TO GET HELP 

This function is one with a built-in Help feature. You can, at any point in the com- 
mand entry sequence, see the Help screen by pressing either the Help key on your 
ATARI series XL Computer, or the ATARI key [ A] on your ATARI 400 or 800 Com¬ 
puter. 

Here is an Illustration showing the appearance of the duplicate disk help screen, 
as it appears when you push the HELP or inverse Video key: 

Duplicate Help Screen 1 of 1 

1. Press D to copy all files in same location onto a new disk—to make an 
exact“logical” duplicate disk. PRESS D WITH DOS DISK IN DRIVE 1. 

2. Source drive number? Enter no. of drive with original. CAUTION: PUT WRITE- 
PROTECT TAB ON ORIGINAL. 

3. Destination drive number? Enter no. of drive with new disk. You can use the 
same or another drive. 

4. Are source and destination the same diskette (Y/N)? Press Y to duplicate files 
on the same disk. Press N to duplicate files on different disks. 

Press P to print this screen 
Press RETURN for more help 

If this help screen has been accessed through the main menu help function, the 
last line on the screen is: 

Press ESC for help menu. 

If this help screen has been accessed while this Utility was loaded, the last line 
reads: 

Press ESC for duplicate screen. 
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THE MEANING OF THIS HELP SCREEN 

Notice that this is the same help screen you see when you use the Help function 
from the main menu when you ask about the Duplicate Function. 

The help screen teils you that a DOS disk must be in drive number 1 betöre this 
function works (as mentioned, it needs the file named D UPDSSK.UTL). 

Item 2 shows you the correct reply to the source driv e number. Notice that it 
does say number rather than “device”. This means that you must say 

1 or 2 or 3 etc, 

specifying the drive numbers to use. You do not specify “Dl ’ 5 or“Dl :’’here. 

Notice at the bottom of this Help menu, it says 

“Press ESC for Duplicate Screen’’ 

What this means is that pressing ESC (once) redisplayss your work screen for the 
Duplicate function. Although you may switch back as orten as you want between 
Help and the data entry screen, note that ESC takes you back to the initial prompt 
and all data input on the screen is lost. 

Be careful not to become confused when you press ~ihe inverse Video or HELP 
key (to go to help), and ESC (to escape from help). If you press ESC while you are 
in the Duplicate function screen, you escape from dupl icate ! This returns you to 
the main DOS 3 menu. 

On the help screen, item 2 also cautions that you should use a write-protect tab 
on the source diskette. This is for your own protection. In the possible event of a 
command entry error, your source diskette cannot be eaccidenfally written over. 

This precaution is not required for your DOS 3 Mastor Diskette in that it has no 
write-protect notch, and is always write protected. Noto however that you should 
normally be using a copy of your master diskette, rathem than the original (except 
of course for the first copy ever) to protect it. In any esse, you may wish to write 
protect whatever source copy you are using to prevent accicJental loss of data. 

Section 3 of the Heip menu teils you what to do whe n you get the second ques- 
tion, the destination drive number. You may make dupl icate copies of a disk using 
either one or two drives. If you have only one drive, then the responses are: 

Source drive number: 1 
Destination drive number: 1 

These are the default responses, so you can, using the main Ouplicate-disk screen, 
press RETURN three times to get the screen to read äs it shows above. 

This working copy can then be used for all of the exsimples used throughout this 
manuai. Note that a copy of the master is REQUIRED r f it is to be written onto. 

This is because, as specified above, the Master Diskette is permanently write pro¬ 
tected. 

The Duplicate screen teils you what to do. Refer to the Duplicate-function menu. 
(Remember it is inverse video/HELP to go to heip, aned ESO to escape from HELP), 
if you have oniy 1 disk unit, you have to specify the fol lowing: 

Source drive number? 1 
Destination drive number? 1 

Note that as each of the command question lines appears, you may either press 
RETURN to make the default response appear, then FRETURN again to accept the 
default, or you may enter your own response. You also have the Option, after the 
default appears, of using the Command Edit function (see “What You Should Know 
Before Using DOS 3”) to change the data to match what you really want to do 
betöre pressing RETURN. 

Now the System leaves your responses printed on the screen, and teils you: 

Insert source disk in drive 1 
Press RETURN 


31 


Once you press RETURN, it reads the source disk, then replies: 

Insert destination disk in drive 1 
Press RETURN 

If the destination disk is found to be unformatted, the initialize disk function is 
automatically performed betöre the destination data is written. Düring the term of 
this single-dri ve copy, System memory is used as the butter (temporary storage 
place) tor the data. DOS provides Status Information on the duplication with a 
series ot messages such as: 

59 blocks remain to be read 
59 blocks remain to be written 

This indicates where the System is in the process ot the duplication. The blocks to 
be read are coming from the source diskette. The blocks to be written are going to 
the destination diskette. 

If you are using a single-disk System tor the duplicate, you may be required to 
swap the diskettes many times. Therefore, the write-protect tab on the source 
diskette is especially recommended if you happen to"slip”once. By accident you 
may have the source disk in the drive when it is supposed to be the destination. 
This could destroy your source data if it is not write protected. Write protect is less 
critical when a two-drive System is used because no diskette swapping is required. 
It is still a good idea, however, that the source be write protected. In the two-drive 
duplicate process, all duplication is done automatically and proceeds to the end 
with no swapping required. 

ADVICE FOR THE NEW USER 

Once the new user has a working copy (also called a System Diskette) of the 
ATARI DOS 3 Master Diskette, the master should be put away in a säte place, and 
only the backu p copy should be used. It desired, multiple copies may be made in 
this manner, baut of course only enough for one’s own personal use. 


HOW TO USE THE ERASE FUNCTION 

The purpose of the Erase function is to remove one or more files from the disk. By 
removing files from the disk, you are telling DOS 3 that the space occupied by 
those files may be used for other purposes. It is a way of making room for other 
files by deletincj those not needed any longer. 

NOTE THAT ONCE YOU TELL DOS 3 TO ERASE A FILE, THERE IS NO WAY TO 
REVERSE THE PROCESS. 

The Erase function is entered by using the first letter E from the main DOS 3 
menu. On entering this function, DOS 3 completes the word Erase opposite the 
word Selection on the command line. It also highlights this selection in the menu 
area. 

Next it asks the question: 

Filespec? 

To ask which f Sie or files you wish to erase. Wildcards may be used in the filespec. 

FOR THE FIRST-TIME USER 

The following set of instructions provides a new file on the disk that you may then 
erase with this function. Note that this Instruction sequence can only be done with 
a disk which is NOT write protected. This means you cannot perform this function 
on your ATARI DOS 3 Master Diskette, but you can use a copy of the master 
which you have made as a backup disk. Simply be certain that the disk you use is 
not write protected. 

1. From the Mein DOS 3 menu, select function F, File Index function. 
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2. When the Computer asks 

Filespec? 

Press RETURN twice. This makes the default appear as 

Filespec? Dl:*.* 

and teils the Computer to accept the default. 

3. When the Computer asks 

Display Device? 

Type D1:FILES 
and press RETURN 

4. The file index appears on the screen and is stored in the disk file named FILES 
on disk unit 1. 

5. Confirm that this name is present on the disk by performing the file index func- 
tion again. This time, select function F, as before, but press RETURN 4 times to 
accept all of the defaults. Now the file index appears on the screen and in- 
cludes the new name called FILES. 

6. Now you can select the Erase function. 

WHEN DOS 3 ASKS ABOUT FILESPEC? 

If you press RETURN, it shows the default filespec of Dl:*.*. If you again press 
RETURN to accept the default, it teils DOS 3 you want to either Erase all files on 
the disk, or DOS 3 presents all of the file names, one at a time, asking individually 
for each file if the file is to be erased. 

If you already know the name of the file you wish to erase, type it as the 
filespec, for example: 

D1:FILES 

or 

D.FILES 

or 

FILES 

All of which are equivalent. This is because D alone assumes the default Dl. 
Likewise, the name alone assumes the default of Dl. You may also specify 
wildcards, in place of the Dl:*.* you could specify 

Fl* 

Here DOS 3 presents to you for decision all files on drive 1 that begin with Fl and 
end in any manner. 

WHEN DOS 3 ASKS ABOUT ERASING ALL SPEC1FIED FILES 

The next question asks if you wish to 

Erase All Speclfied Files (Y/N)? N 

Note that the default reply N is already in place 
If you press RETURN at this point, it means that you wish DOS 3 to ask you 
whether this is the file you want to erase each time a file name matches the 
filespec you have given. Then for each file match, you see the message: 

Erase D1:FILES. (Y/N)? N 

This means that to actuaüy erase the filename, you need to take positive action, 
changing the N to a Y, and press RETURN. This protects you from a possible error 
by giving you a last Chance to change your mind. 

When DOS 3 asks about erasing all files with matching filespecs, if you change 
the N to a Y, for Yes, it means just go ahead and erase all files matching the 
filespec. in other words, don’t ask questions, just do it. 


33 


HOW DOS 3 REPORTS PROGRESS 

As it ac'cepts your instructions that a file is to be erased, it reports on the screen: 

Erasing D1:FILES 

Next it reports on the Status line fhat the specified file name has been erased. 
Note that DOS 3 does not erase protected files. Then, once all matching files have 
been found, questioned, and bypassed or erased, it reports completion Status on 
the statu-js line of the main menu as: 

Job Cownpleted. n Files erased 

The n r«apresents the total number of files actually erased. 

IF YOU NEED HELP 

While thme Computer is asking you for Information, you may press the ATARI key or 
the HEI_P key to see the following summary of the Erase entry instructions: 

Erase l-lelp Screen 1 of 1 

1. Pres s E to delete one or more files from your disk. (DOS will not erase Pro- 
tected files.) 

2. Filespec? Specify files to delete. Wildcards can be used. CAUTION: ERASED 
FILES CANNOT BE RECOVERED. 

3. Eras-e all specified files (Y/N>? Press Y to delete all files named by filespec 
Pres s N or RETURN to erase files one at a time. 

4. If erasing one by one, DOS gives you a Y/N Option for each file. Erased 
filen ames should no longer appear in file index. 

Pres s P to print this screen. 

Pres s RETURN for more help. 

Press ESC for HELP Menu. 

After you have read the Help Information, press ESC twice to return to the main 
DOS 3 menu. Then you may restart the ERASE function. 

HOW TO USE THE FILE INDEXTUNCTiON 

This comnmand is used to view the list of the files stored on a diskette. it is selected 
from main DOS 3 menu using the first letter F. 

It allcows you to specify the file names you are looking for and list only those you 
wish. As an alternative to simply listing the file index on the screen, you may direct 
it to bo printed out, or piaced on the disk as a separate file. 

These options are: 

FOR TN E FIRST-TIME USER 

The mo st common thing you do is to list the contents of the diskette in disk drive 
numbe r 1 . This is what all of the System defaults are set to do, so this is the first 
exampö®: 

LIST TO THE SCREEN THE CONTENTS OF DISKETTE IN UNIT 1 
When you type F, DOS 3 responds by typing the rest of the command 

File Ind ex 

opposite the word 

Selecti on? 

At the same time, it highlights the selection in reverse Video in the menu selection 
portion of the display. 

On the next prompt line, it asks: 

Filespec? 
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At this point, the simplest set of replies accept alf of the System defaults. That is, to 
list all of the files residing on disk drive 1. This consists of press üng RETURN four 
times. The System does the rest. 

Examine what the System places on the screen each time yoi_j press RETURN: 
Selection? File Index 
Filespec? (before you press RETURN) 

Filespec? Dl:*.* 

(after pressing RETURN once) 

Filespec? Dl:*.* 

Display Device? 

(after pressing RETURN a second time, it has used the default f = ilespec showing D 
for disk unit, 1 for unit #1, and *.* for a wildcard, saying to list all files which 
matoh this combintion. Since a wildcard is used before and afte r the (.) it matches 
ALL filenames. Therefore, all file names appear in the file index list.) 

Selection? File Index 
Filespec? Dl:*.* 

Display Device? E: 

(after pressing RETURN a third time. This says that the default cdisplay device is E: 
This means to send the display to the screen. 

Now if RETURN is pressed a fourth time, accepting all of the dsfauit conditions, 
the screen is cleared, and the file index is sent to the screen. If there are more 
than 18 files to be listed, then at the bottom of the screen is the foliowing instruc- 
tion, called a “prompt": 

Press RETURN for more file index 

When you have displayed the final page of the file index at the tzDOttom of the page, 
it States: 

Press RETURN for menu 

This returns you to the main DOS 3 menu. The file index display itself shows you a 
number of things about the diskette in the selected disk unit. First, it shows the 
filenames of all of the files and the “extensions" (see the sectio n titled “What you 
should know before using DOS 3" if you are unfamiliar with this term). It also lists 
the amount of space in “blocks" which is taken up by each one of these files. A 
block is 1024 bytes (memory locations). 

If there are any “protected" files on the disk, there is an aste^ risk (*) in the far 
left-hand column of the file index for that filename. For more infcormation about pro- 
tected files, see the section titled “How to Use the Protect Funcrdion." 

Finally, the file index teils you how many free blocks there are on the disk. This 
Information lets you determine if there is going to be enough room left on the disk 
to störe the next set of programs you are working with. I f you a3 ready know that a 
program takes up about a certain number of blocks, you can fig Lire out if it fits. If 
there are no blocks free, you cannot störe any more files on a cdisk. To make areas 
free again, you have to use the Erase function. 

For the first time user, it would be best, at this time, to make a backup copy of 
your Master Diskette. Turn now to the section titled “How to us e the Duplicate 
Function" to find out how to do this. Then, if you wish, you may return to this sec¬ 
tion or simply proceed to other segments of the manual as you oeed to do certain 
functions. 

OTHER OPERATIONS POSSIBLE WITH FILE INDEX 

When the menu specifies: 

Selection? File Index 
Filespec? 
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In this case you may specify your own filespec instead of pressing RETURN. For 
example, you couid specify disk unit number 2, as: 

Filespec? D2: 

To list all of the files on drive 2. Note that for the file index function, when the 
filespec is accepted by the RETURN key, it fills in the wildcards *.* if it finds only 
the filespec Dl: which makes it exactly equai to Dl:*.* 

USE OF WILDCARDS 

If you specify the wildcard *.*, DOS 3 is going to list the names of all of the files, 
regardless of their names. If you are looking to see if a specific file is on the 
diskette (at your request) it lists only those that have certain features. For example: 

Filespec? *.BAS 

Note that this command lists only files that have a .BAS as their file type extension. 
Notice in this example that the re is no mention of the disk unit number in the 
filespec. DOS 3 assumes that the device to be used is a disk, and that the unit 
number is 1; it assumes this unless told otherwise. 

The other is the single character wildcard (see the section on wildcards in“What 
you should know before using DOS 3”). For example: 

Filespec? H7LL.BAS 

This would matoh the names HALL.BAS and HILL.BAS for example. Therefore such 
names, if present on the disk, would appear in the file index list if the command 
was given. 

REDIRECTING THE FILE INDEX LIST 

DOS 3 allows the file index üsting to be directed to any device. The most common 
destinations for the file index are the screen (E:) and the Printer (P:). Since the 
screen is by far the most common, it is the default. Specifying P: before you press 
RETURN directs it to the printer. You may, if you wish, direct it to any other 
device, including a disk file if you desire. In this case, you might specify, for exam¬ 
ple: 

Filespec? Dl:*. * 

Display Device? D2:DISK1 OO.NDX 

This would form a new file named DISK1 OO.NDX on the diskette in drive 2, contain- 
ing the index of the disk in unit 1 . This is a way of forming a kind of a catalog that 
you might later use to keep track of what program is on which disk. 

Note that in each case where you have pressed RETURN to answer a question, 
such as: 

Filespec? 

or 

Display Device? 

and have received on the screen the default, you do not need to accept the default 
condition. You may 

1. use the editing keys to move the Cursor, and change the default to what you 
need, or 

2. use the SHIFT + CLEAR to restart the command, or 

3. use the SHIFT + DELETE to erase the default and restart this part of the com¬ 
mand only, or 

4. use the ESC key to return to the main menu. 
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IF YOU NEED HELP 

While the Computer is asking you for information, you may press the ATAFRI key or 
the HELP key to see the following summary of the File Index entry instruotüons: 

File Index Help Screen 1 of 1 

1. Press F to select this function. The index teils you which files are on your 
disk. 

2. Filespec? Specify files you are looking for. To see all files on disk, pr«ss 
RETURN. Dl:*.* is the default response. 

3. Display device? Press E: or RETURN to list Index on screen. Press P: to print 
Index. Index iists filenames, extenders, file sizes in blocks and number of free 
blocks ieft. 

4. If list exceeds one screen, press RETURN for more files. 

Press P to print this screen 
Press RETURN for more help 
Press ESC for HELP menu 

After you have read the Help information, press ESC twice to return to th 3 main 
DOS 3 menu. Then you may restart the File Index function. 

HOW TO USE THE GO-AT-HEX-ADDR FUNCTION 

This function is used normally by the assembly language programmer. It is 
selected by the fetter G from the main DOS 3 menu. On selection, DOS 3 oom- 
pletes the word Go-at-hex-addr opposite the word Selection, and highlighte this 
selection in the menu area. 

This function is cailed to direct DOS 3 to transfer control to a specified hex ad¬ 
dress. it is normally used to restart a program which was placed on the di 3 k using 
the SAVE function of DOS 3. 

This function is used either if you SAVEd a program specifying a RUN address, 
or for which you teil DOS 3 during the Load, that it is NOT to RUN this pro>gram. 
When it specifies: 

Run addr (Hex)? 

This specifies a hex address in the ränge 0000 to FFFF. On pressing RETURN, it 
immediately transfers control to the specified address. Note that this address must 
contain executable code, or eise unpredictable results occur. 

Example: If you wish to try this function, specify E477 and press RETURN1 . This 
reboots the System. 

IF YOU NEED HELP 

While the Computer is asking you for information, you may press the inverse Video 
key or the HELP key to see the following summary of the Go-At-Hex-Address entry 
instructions: 

GO-AT-HEX-ADDR HELP SCREEN 1 OF 1 

1. Press G to enter RUN addr for assembly language program in RAM. 

You will need to use GO if you SAVE 
your program file with no RUN addr. 

2. Run addr (HEX)? Enter hex RUN addr. CAUTION: 

ADDR MUST CONTAIN EXECUTABLE CODE. OTHERW1SE, ERRORS REQUIR1NG 
REBOOT MAY RESULT. 
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Press P to print this screen 
Press RETURN for more help 

After you have read the Help Information, you have to press ESC to return to the 
main DOS 3 menu. Then you may restart the Go-at-hex-addr function. 


HOW TO USE THE HELP FUNCTION ~ 

This function is seleated from the main DOS 3 menu by the fetter H. Its purpose is 
to provide you with an “online” or immediately available way of accessing helpful 
information about using DOS 3. On selecting this function, DOS 3 highlights this 
function name in the menu area, then completes the word Help, as: 

Selection? Help 

On the bottom section of the screen, it States: 

LOADING D:HELP.UTL ... 

This means that this f ile must be present on the disk in drive 1 in order to run this 
function. 

Next, the screen is cleared, and a duplicate of the main menu, this time titled' 

HELP MENU 

Beneath that new menu, it States: 

Help On Which DOS function? H 
Press H for general information 

In the question line, the default, H, is already present. Therefore, if you simply 
press RETURN, the System provides you with six different screens specifying 
general information about the use of DOS 3. These screens are printed within this 
section. Further information about the data covered in these screens may be found 
in the section titled “What You Should Know Betöre Using DOS 3.” 

You may specify any of the other functions, to read and/or print their help 
screen information. Each time you make a selection, the Help menu indicates: 
Help on the way ... 

This display shows while it is searching for the correct information screen. This in¬ 
formation is taken from a file on the Master Diskette called HELP.TXT. Therefore, 
to get help from the Help function, this file must also be on the disk contained 
in drive 1. 

When it presents the Help screen to you, you have a choice for each: 

Print the screen (your printer must be on), RETURN to see the next screen if there 
is more than one, otherwise the current one is redrawn on the screen, or ESCape 
to the Help menu again for another possible selection. 

From the main Help menu, you may press ESC to return to the main DOS 3 func¬ 
tion menu or select another item for which to view its help information. 

The Help screens for each of the DOS 3 functions have been placed, throughout 
this manual, in the sections where the function itself has been described. The 
screens contained immediately following are the general information Help screens 
mentioned above. 

(The rest of the Help screens are listed under a subtitle “If you need help” or 
“How to get Help” in the sections describing the individual DOS 3 functions.) 
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GENERAL INFORMATION -1 OF 6 

The DOS commands allow you to störe, retrieve, and manage your disk files. 

1. To select a menu function, press the first letter of the commancJ name. (Erase 
... press E, etc.) 

DOS prompts you to supply the data needed to execute a commamd- When 
response is comptete, press RETURN. 

2. To get Help on any DOS function, press the inverse Video or HELP key instead 
of typing in requested data. 

3. To break out of any DOS function, press ESC key for the DOS me rau. 

Press P to print this screen 
Press RETURN for more help 

GENERAL INFORMATION - 2 OF 6 

Some DOS commands are stored on the DOS disk and are loaded into the Com¬ 
puter when selected. 

Thus, keep DOS disk in drive 1 when selecting: 

1. Copy/Append 

2. Duplicate 

3. Init disk 

4. Access DOS 2 

5. X-user-defined 

6. Help 

These files are stored on the DOS disk to leave you more available rraemory in 
your Computer. 

Press P to print this screen 
Press RETURN for more help 
Press ESC for Help menu 

GENERAL INFORMATION - 3 OF 6 
DOS asks you for data such as: 

t. Filename? The full name of your file. (MYFILE.BAS) 

2. Filespec? The filename plus the drive ID. (Dl :MYFILE.BAS) 

Wildcards can be used for 1 and 2. 

= Any combination of characters. 

= Any single character. 

3. Device: Dn:= drive no.; E: = screen; P: = printer; C: = cassette. 

4. Source—? From which—? 

Destination—? To which—? 

Press P to print this screen 
Press RETURN for more help 
Press ESC for Help menu 

GENERAL INFORMATION - 4 OF 6 

Answers to prompts sometimes appear highlighted (Drive number ?“1). DOS picks 
these preset values (defaults) for you when you press RETURN. 

The default filespec is Dl:*.* (ail files on the diskette in drive 1). 

When using wildcards, DOS asks you if you want to act on all files: function all 

specified files (Y/N)? 

t. Press Y to process all files automatically. Press N or RETURN to parocess files 
one at a time. 
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Press P to print this screen 
Press RETURN for more help 
Press ESC for Help menu 

GENERAL IMFORMATION - 5 OF 6 

As noted in the previous screens, the RETURN key is used: 

(a) To Signal the end of your response to a prompt, and 

(b) To select the default value in response to a prompt. 

There are two more points to note: 

1- When in doubt, RETURN is safe. If you answer RETURN to a prompt, DOS 
never does anything to your files. 

2. When DOS asks (function) all specified files (Y/N)? Press RETURN to see each 
filename in filespec. 

Press P to print this screen 
Press RETURN for more help 
Press ESC for Help menu 

GENERAL IMFORMATION - 6 OF 6 

You know atoout using the HELP or inverse Video, ESC, and RETURN keys. But 
there are four other special uses for the following keys: 

1. SHIFT-CLEAR causes a DOS function to restart from the first prompt for data. 

2. SHIFT-DELETE deletes your response to the current prompt only. 

3. BACK SPACE erases the character preceeding the Cursor. 

4. CTRL /CTRL moves the Cursor without erasing any characters. 

Press P to print this screen 
Press RETURN for more help 
Press ESC for Help menu 

HOW TO USE THE INIT FUNCTION 

This function is selected by pressing I from the main DOS 3 menu. When I is 
pressed, the System command line specifies: 

Selection? Init disk 

Then highlights these words in the menu selection area. It places the following line 
at the bottom of the menu screen: 

Loading D:INIT.UTL ... 

This means thrat this file name must be on the disk in drive 1 at the time you try to 
execute this function. 

The Init function of DOS 3 is used to prepare a disk for use. It writes "formaf ’ 
Information on the disk as described in the section titled "Format” in the chapter 
titled "What V"ou Should Know Betöre Using DOS 3”. 

FOR THE FIRST-TIME USER 

The function rmost likely to be used by the first-time user is to format a disk in disk 
unit 1. This example shows this action. 

1. To format disk, you must first be sure that the write protect notch is NOT 
covered. Thiis allows the Computer to write new Information onto the disk. 

2. When the Init Utility program has been loaded, the screen appears as follows: 

The first line s^ays 

Format diskette in drive (1-8)? 

Press RETURM to make the default response appear, as: 

Format diskette in drive (1-8)? 1 
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This is the drive where you place your new disk, which is to be for mattend. If you 
have a single-disk System, it is always drive 1. When the question first appears, the 
Cursor is at the end of the line, waiting for you to specify the drive number. If you 
press RETURN once, the number 1 appears. You may change it, and in itialize a 
disk in a different drive if you wish. Then press RETURN again to ask th e Com¬ 
puter to accept the number you have entered as the drive to initialize. 

Now the Computer asks: 

1 for single density 

2 for double density 

If you press RETURN, the default 1 appears. This is because this formal is the 
only one the ATARI 810 Disk Drive may perform, and the only one that mnay be 
read by all ATARI disk drives. If you intend to exchange Software with a riy other 
ATARI Computer owner who uses an 810 disk drive, this is the format you should 
choose. Next the Computer asks: 

Write FMS.SYS files? N 

This line shows the default response, N, that you get on the screen if yo u just 
press RETURN. The other possible response is Y. This says that the diskette you 
are initializing should be a System Diskette, capable of “booting” DOS 3. Use the 
command edit functions to modify the line to read Y or N, then press RETURN to 
ask the Computer to accept that response (Y for System disk, or N for cäata disk). 

If you have selected Y as the response to the above, then the followi mg line 
appears: 

Modify FMS Parameters? N 

This line is shown with the default response you get by pressing RETUFR N once. 
This is the normal response. Press RETURN to accept it. The advancecd user 
should refer to the section titled “Modifying the File Manager” below for more In¬ 
formation about the other option (Y) here. Now the Computer clears the screen, 
and summarizes for you just what you told it to do. 

CHANGING PART OF A COMMAND 

If you have entered a command incorrectty, you may restart that command by 
pressing SHIFT/CLEAR at any time during your command entry in the I nit 
function. 

For Information about other ways of changing the commands you ha^e entered, 
see the section in this manuai titled “Command Editing.” 

RETURNING TO THE DOS 3 MENU 

If, during the command entry mode, you decide you don’t want to perform this 
function after all, you may press the ESC key. This reloads the DOS 3 rmain menu. 

TO START THE FORMAT 

Follow the instructions given at the bottom of the summary page. Wheri you press 
RETURN, the Computer informs you about the progress of the format Operation, 
with the line: 

Now formatting diskette ... 

and finaily the lines 

initiaiization compieted. 

Press RETURN to init next diskette 
Press ESC to return to DOS 

Ät this point, if you just press RETURN, the summary page is restored tto its 
original appearance. This is a continue Operation to allow you to initiali^ie more 
diskettes in exactiy the same way in the same disk unit if you wish, wit rmout going 
through the data entry process again. If you press ESC you return to tf r e main 
DOS 3 menu. 
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MODIFYING THE FILE MANAGEMENT SYSTEM 

The command response Y to the question 

Modify FMS Parameters? 

brings up thie following responses. The default replies are shown in the sample 
lines below. with an explanation of what each one meahs. Modifications to these 
items is usua lly done by a more advanced user. 

Starting ad<Jress of FMS buffers? 1A7C 
Number of System buffers (2-16)? 5 
Verify writ^ commands (Y/N)? Y 

Taken in the Order they are shown: 

Starting address of buffers? 1A7C 

The fiie manager (FMS) maintains buffers for the data which is to be sent to or 
received frorri the disk or any other unit which it is Controlling. This address 
specifies whe?re the buffers begin. A user may choose to relocate them up in a 
higher area of memory in Order, for some reason to use this particular space 
allocated fo> r the Standard FMS, however the size of the buffers (see below) deter- 
mines exactrly where the starting address may be defined. 

Number of System buffers? 5 

This specifies the total number of disk units plus the number of files open at any 
one time, w fnether for input or output. Each System buffer is 128 bytes long. This 
limits the number of OPEN commands that may be issued to the FMS. 

Verify write-commands? Y 

This is the rso rmal response. Yes says that when a disk write is issued, the System 
should read the data back again, to verify that it was written OK and can be read 
again later. If it is not OK the first time, this aliows the System to put the same data 
somewhere ellse on the disk and mark the unreadable area as bad. A user usually 
selects the PNI Option to speed up the data transfer to the disk, but in the process is 
taking the c fhance that a disk write error may cause the data to be unreadable 
later. It is upo to the user to balance the needs for speed against the possible 
Chance of p roblems in disk reading. 

When all these options are selected, they appear in the summary display. As with 
all other opttions, pressing RETURN once without typing anything makes the 
default Option, appear. Pressing RETURN again with the default or the actual selec- 
tion present teils Init to accept the data, and go on to the next function. 

HELP FOR THIS FUNCTION 

A Help scre en for this function may be viewed by pressing the inverse Video key 
or the Help key. The Help screen for this function is the same one you see if you 
select the He0p function from the main menu. However, this Help screen may be 
accessed back and forth from the Init function without exiting Init. You always 
press the inverse Video key or HELP key to enter Help for this function, then the 
ESC key OMCE to exit to the data entry menu. You may go back and forth as 
many times as you wish. But be careful not to press ESC from the data entry 
menu, since- this exits the function and returns you to the main DOS 3 menu. 

The Init Help screen contains a summary of the Information specified in this sec- 
tion, and appears as follows: 

Init Disk Help Screen 1 of 2 

1. With DOS Disk in Drive 1, press I to initialize disk. 

CAUTION: Initializing a disk erases all data on the disk. 
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2. Format diskette in drive (1-8)? Enter no. of drive with disk to be initialized. 
NEVER INIT YOUR DOS DISK. 

3. Format type? Press 1 for single-density formst; press 2 for double-density 
format. 

Init Disk Help Screen 2 of 2 

4. Write FMS.SYS file (Y/N)? This file lets you boot the System from this disk- 
Press Y to write file; press N or RETURN to format only. 

5. Modify FMS parameters (Y/N)? This lets you increase usable memory. Press Y 
to modify; press N or RETURN to bypass modification. 

If you press Y for Step 5, answer: 

a) Start address of FMS buffers? 

b) Number of FMS buffer (2-16)? 

c) Verify write - commands (Y/N)? 

DOS asks you to confirm init values. 

Press P to print this screen 
Press RETURN for more help 

If this Help screen has been accessed through the main menu help function, the 
last line on the screen reads: 

Press ESC for Help menu 

If this Help screen has been accessed while this utility was loaded, the last line on 
the screen reads: 

Press ESC for init disk screen 


HOW TO USE THE LOAD FUNCTION 

This function is called from the main DOS 3 menu by typing L. 1t is used to bring 
back, into memory, data which was sent to the disk using the Save function. It is 
intended for the advanced user. 

When you type L, it makes the selection line appear as follows: 

Selection? Load 

and, at the same time, highlights the Load function in the main menu. 

It then asks: 

Filespec? 

requesting that you specify which device and filename holds the file you wish to 
load. A valid example is the one which was used in the example of the Save 
function. 

Filespec? D1:MEM3000 RETURN 

The system then searches the source device and gives you another chance to 
think about whether this is the file you wanted. (Wildcards can be used in this 
filespec, so you may or may not want to load the file the system presents to you as 
a possible choice.) When DOS 3 has found a file that matches the filespec you 
have given, the system will present a question at the bottom of the menu. This 
question it is asking teils you that it has indeed found a file which matches the 
filespec you have given. 
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In the example, the System would present the question at the bottom of the 
menu: 

Load Dl :MEM3000 (Y/N)? N 

wdth the default N already on the screen. If you just press RETURN here, the tile is 
not loaded. If you change the N to a Y, for Yes, the file is loaded. 

If there is an IN IT address associated with the file it toads, DOS 3 performs a 
JSR to it for initialization, If there is a RUN address which had been saved with the 
fi Be, DOS 3 could JSR to St foliowing the optional INIT routine. See the explanation 
of INIT and RUN addresses in the section of the Save function. If there is a RUN 
address Saved with this file (see the DOS 3 Save function), then DOS 3 asks, atter 
performing the INIT function, whether this newly loaded program or memory seg- 
rment is to be run by the question: 

Run this file (Y/N)? N 

Nlote that the default, No, is already printed on the screen, If you do wish to RUN 
it:, change the N to a Y, for Yes, then press RETURN. 

If a wildcard has been used in the filespec, and if there is more than one file 
which matches this filespec on the source device, you may continue to answer 
Y^es as the System asks: 

Load (name of file you typed in) (Y/N)? N 

for the loading of each one. Loading terminates, however, with the load of the first 
file which has a RUN address Saved within it, and for which you specify that you 
cio indeed want to run this program. This is because DOS 3 loses control over the 
System at this point in favor of granting control to the loaded routine. 

If you have chosen not to RUN the program which was loaded and elect to start 
the program later, after nnore DOS 3 operations, you may use the G function, Go- 
eit-hex-address to start the program. See this function for more details. 

IF YOU NEED HELP 

While the Computer is asking you for Information, you may press the inverse Video 
key or the HELP key to see the foliowing summary of the Load entry instructions: 

Load Help Screen 1 of 1 

t . Press L to load into selected memory area a previously saved assembly 
language program. 

2 . Filespec? Enter filespec of file to be loaded. Wildcards are OK. If wildcards 
are used, DOS shows you each filename and asks you which file to load. 

3. After selecting file to be loaded, DOS asks Run this file (Y/N)? Press Y to run 
the file. Press N or RETURN if not to run the file. 

Press P to print this screen 
Press RETURN for more help 

After you have read the Help Information, press ESC to return to the main DOS 3 
menu. Then you may restart the LOAD function. 



HOW TO USE THE MEM.SAV FUNCTION 

This function allows you to change DOS 3 so that it automatically saves certain 
memory areas in a file in drive 1 calied MEM.SAV. This function a! lows you to use 
many of the DOS 3 functions without disturbing a program which you may be cur- 
rently working on in the command entry mode in ATARI BASIC. 

DOS 3, when calied, saves the content of lower memory into a lile named 
MEM.SAV. This is the memory space that DOS itself needs to perform most of its 
normal functions. 

Basically, when you boot DOS 3 with a cartridge present, the files KCP.SYS and 
FMS.SYS are loaded. These two fiies are the ones which perform most of the nor¬ 
mal functions of communicating between you and the disk. They handle all of the 
normal commands that you can Issue from BASIC and operate in memory along 
with BASIC. When you want to do a DOS 3 menu command, you must type DOS 
and press RETURN. DOS 3 at this point loads the file named KCPOVER.SYS in 
order to write the menu and to be able to understand the menu commands. 

If the function MEM.SAV is active, it either creates or replaces a file named 
MEM.SAV on disk 1. This is used to störe temporarily the current contents of the 
memory space it needs to use for KCPOVER.SYS. Then, if no more space is need- 
ed during the performance of any of the DOS commands which yo>u use, DOS 3 
can use this MEM.SAV file to restore the original contents to this memory area 
when you perform the To-Cartridge function. 

This function either enables or disables the MEM.SAV Option. When you enable 
MEM.SAV, it creates or uses a file on disk unit 1. Therefore this disk cannot be 
write protected if this function is used. When you enable MEM.SAV^, it deletes the 
file. 

If MEM.SAV is disabled when you type DOS, the DOS control files are loaded in¬ 
to memory and erase your program. When you return to the cartridge, the existing 
program is gone. 

Note that it takes a few seconds either to go from BASIC to DOS or from DOS to 
BASIC if MEM.SAV is used. This is because it takes some time to write or read the 
5 blocks that MEM.SAV uses. You must decide whether it is necessary to have this 
autosave of the lower memory. If you don’t offen use DOS right in the middle of 
program entry, you probably want to keep MEM.SAV off. This saves the time it 
takes to read or write these files as you go from BASIC to DOS and back. 

HOW THE FUNCTION IS CALLED 

Press the M key from the main DOS 3 menu. DOS 3 completes the function name 
MEM.SAV opposite the prompt name Selection. )t also highlights th is selection in 
the menu area. Then it asks: 

Use MEM.SAV (Y/N)? 

Note that the default response, the current setting, is already present. If you press 
RETURN at this point, MEM.SAV Status remains the same. If you c hange? the 
response and then press RETURN, the MEM.SAV Status is changed accordingly. 

You can teil if it is currently active or not by looking in the DOS 3 Menu area. 

The word includes a dot, for example; 

MEM.SAV 

If the dot is shown, the function is active. In this case, the lower memory is 
restored when going back to the cartridge and any program in memory s hould be 
present on return. 

There are cases however, where this is not true. In particular, the DOS 3 menu 
functions INIT DISK, COPY/APPEND, DUPLICATE, and ACCESS DOS 2 and HELP 
require more space than normally can be held in tfre MEM.SAV file. Therefore, if 
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you expect to be using these functions, the MEM.SAV is not able to save your en- 
tire program in memory and still allow DOS 3 to perform the function. 

Therefore, yo«u should always SAVE your program currently in memory using the 
BASIC SAVE or ILIST instruction betöre typing DOS to perform one of these more 
complex DOS 3 functions. Basically, any function which has a file on the master 
diskette with the extension UTL needs more space, and if it is used, makes the 
MEM.SAV inforrrmation invalid. 

Whether you elect to change from MEM.SAV active to inactive or vice versa, the 
prompt you see when you type RETURN is: 

Updating KCP.SYS ... 

if MEM.SAV was active, the command response is then to erase the file named 
MEM.SAV from “the disk. It also removes the dot from this item in the command 
area. 

One final note ... if you have the MEM.SAV function active, and you have exited 
BASIC by typing : DOS 

In this case the re are three things you should not do if you wish the MEM.SAV 
function to restore your program to the memory on the return to the Cartridge: 

a. Do not perfo rm one of the complex functions mentioned above, 

b. Do not ERASE the file named MEM.SAV in disk unit 1, 

c. Do not issue the To-Cartridge function until the same disk, which was in unit 1 
at the time y ou exited to DOS, has again been placed in unit 1. This assures 
that the same MEM.SAV file, written at the time you exited to DOS, can be 
restored to the memory again. 

IF YOU NEED HELP 

While the Computer is asking you for information, you may press the inverse Video 
key or the HELi 13 key to see the following summary of the MEM.SAV entry instruc- 
tions: 

MEM SAVE HELP SCREEN 1 OF 1 

1. Press M to s elect MEM.SAV Option. When MEM.SAV is active, you can use a 
part of memory usually used by DOS. 

When using EDOS with MEM.SAV on, the contents of lower memory are saved 
to disk in MEM. SAV file. When MEM.SAV is off, DOS may “overwrite” some of 
your data in meinory. 

2. Use MEM.SAV (Y/N)? Press Y to turn on MEM.SAV Press N to turn off MEM. 
SAV C/U. Press RETURN to leave MEM.SAV as is. 

3. Check DOS menu: When MEM.SAV on, the name has a dot: Mem.Sav 
Press P to print this screen 

Press RETURN for more help 

After you ha \re read the Help information, you have to press ESC to return to the 
main DOS 3 me?nu. Then you may restart the MEM.SAV function. 


HOW TO USE THE PROTECT FUNCTION 

This function is selected from the main DOS 3 menu by pressing the letter P. It is 
used to modify one or more entries in the file index. Its purpose is to mark these 
entries as permanent fites. Such files are not to be erased by the System using the 
erase utility, nor are they to be replaced by any file of the same name, or have 
anything eise ap>pended to them. Thus the name PROTECT. 
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When this function is selected, DOS 3 highlights the name in the menu area, and 
completes the word opposite the question: 

Selection? Protect 

Then DOS 3 asks: 

Filespec? 

The default repiy, if you press RETURN here is: 

Filespec? Dl:*.* 

which means to protect all fiies on drive 1. You may edit this response if you wish, 
betöre pressing RETURN. 

If you give a specific filespec, such as: 

Dl :COPY.UTL 

Protection is added only to that file name on the source disk. However, if you 
specify any wildcards, you receive, as the next question: 

Protect all specified fiies (Y/N)#N? 

Here, the default repiy, No, if you press RETURN, directs the svstem to ask you 
whether or not to protect each file it finds, in turn, matching the wildcard filespec 
you specify. If you change this repiy to Y, for Yes, it does not ask any more ques- 
tions and proceeds to protect all matching filespecs, reporting each as it is done. 

Note that the disk you are trying to “mark” the protection on must not itself be 
write-protected. This would prevent the updating of the file index and cause an er¬ 
ror. It is not an error to add protection to a filename which is already protected. 

IF YOU NEED HELP 

While the Computer is asking you for information, you may press the inverse Video 
key or the HELP key to see the following summary of the Protect entry instruc- 
tions: 

PROTECT HELP SCREEN 1 OF 1 

1. Press P to write-protect fiies. Protected flies carmot be written to, erased, 
renamed, or appended. 

2. Filespec? Specify fiies to protect. Wildcards can be used. 

3. Protect all specified fiies <Y/N)? Press Y to protect all fiies named by filespec. 
Press N or RETURN to protect fiies one at a time. 

4. If protecting fiies one at a time, DOS shows you each filename and gives you 
a Y/N Option. Check File Index. Protected fiies have (*) in front of filename. 

Press P to print this screen 
Press RETURN for more help 
Press ESC for Help Menu 

After you have read the Help information, you have to press ESC to return to 
the main DOS 3 menu. Then you may restart the Protect funotion. 

HOW TO USE THE RENAME FUNCTION 

The purpose of the Rename function is to change the name of one or more fiies on 
the disk. It is normally used on single fiies. 

The Rename function is entered by using the first letter R f rom the main DOS 3 
menu. On entering this function, DOS 3 completes the word Rename opposite the 
word Selection on the command line. It also highlights this seleetson in the menu 
area. Now it asks the question: 

Old filespec? 
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To ask which file or fites you wish to rename. Wildcards may be used in the 
filespec. 

FOR THE FIRST-TIME USER 

This set of instructions provides a new fiie on the disk which you may then 
Rename with this function. Note that this instruction sequence can only be done 
with a disk that is NOT write-protected. This means you cannot perform this func¬ 
tion on your /^TARI DOS 3 Master Diskette, but you can use a copy of the master 
which you a!ready have made as a backup disk. Just be certain that the disk you 
use is not writ:e-protected. 

1. From the main DOS 3 menu, seiect function F, File Index function. 

2. When the ccomputer asks 

Filespec? 

Press RETURN twice. This makes the default appear as 

Filespec? EDI:*.* 

and teils tln «e Computer to accept the default. 

3. When the Computer asks 
Display Device? 

Type Dl :FI C_ES 
and press FRETURN 

4. The file index appears on the screen and is stored in the disk file named FILES 
on disk unit 1. 

5. Confirm that this name is present on the disk by performing the file index func¬ 
tion again. “This time, seiect function F, as before, but press RETURN four times 
to accept a. CI of the defaults. Now the file index appears on the screen and in- 
cludes the new name called FILES. 

6. Now you can seiect the Rename function. 

WHEN DOS 3 WSKS ABOUT OLD FILESPEC 

If you press RETURN, it shows the default fitepec of Dl If you again press 
RETURN to ac^cept the default, it teils DOS 3 you want to either Rename all fites 
on the disk, or you can have DOS 3 present to you all of the file names, one at a 
time, asking you for each if this file is to be renamed. Note that this second func¬ 
tion is the most likely. No two files can have the same name, so once the correct 
one is found, you won’t want to rename others. 

If you alreacJy know the name of the file you wish to erase, type it as the 
filespec, exampoie: 

Dl :FILES 
or 

DrFILES 

or 

FILES 

all of which are equivalent. This is because D alone assumes the default Dl. 
Likewise the name alone assumes the default of Dl. You may also specify 
wildcards, in place of the Dl;*.* you could specify: 

Fl* 

Here DOS 3 wcould present to you for decision, all files on drive 1 which began with 
Fl and ended im any manner. 

WHEN DOS 3 ASKS ABOUT NEW FILESPEC 

The next questä on is: 

New Filespec? Dl: 
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Note that there is no default file name. You must provide a new name which DOS 
3 uses for this file. For example: 

New filespec? D1:FILEINDX 

The specification Stands for file index. Note that DOS 3 provides the cäevice portion 
of the new filespec for you (the device portion may not be edited). 

HOW DOS 3 REPORTS PROGRESS 

If you press RETURN at this point, DOS 3 searches the source device. If it 
matches the old filespec, it presents you with the question: 

Rename D1:FILES to FILEINDX (Y/N)? N 

In this case, you must change the N to a Y before pressing RETURN to actuaily 
rename the file. If you just press the RETURN at this point, you get thoe message, 
in the Status line 

Job completed. 0 files renamed 

If you changed the N to a Y, then DOS 3 reports 

Renaming D1:F1LES to FILEINDX 

and the Status line will report 

D1:FILES Renamed 

You may, if you wish, specify wildcards in the selection of the old filespec, such 
as: 

Old Filespec? Fl* 

In this case, DOS 3 asks: 

Rename all specifled files (Y/N)? N 

Note that the default N is already present. If you press RETURN, it m ^sans that 
DOS 3 is to search for all matches, and present each matching filenarrie for your 
decision. 

If you change the N to a Y, for Yes, it means just go ahead and Re name all files 
matching the filespec. In other words, don't ask questions, just do it. r^Jormally, only 
one file is to be renamed. 

In fact, this function halts, indicating an Error 1 74 - Duplicate Filename if you try 
to give the same name to more than one file. DOS 3 does not know w^hich file you 
really want to continue having this name, so it refuses to create a pro äolem in this 
manner. 

Once all matching files have been found and questioned, bypassed or renamed, 
DOS 3 reports completion Status on the Status line of the main menu as: 

Job Completed. n files Renamed 

In this case, the n represents the total number of files actuaily renamed. 

IF YOU NEED HELP 

While the Computer is asking you for information, you may press the i rnverse Video 
key or the HELP key to see the following summa ry of the RENAME en try instruc- 
tions: 

RENAME HELP SCREEN 1 OF 1 

1. Press R to change the filename or extender of one or more files - 

2. Old Filespec? Enter filespec to be renamed. Wildcards can be us^d. 

3. New Filespec? Enter the new filespec. DOS will not allow duplica~*e filenames 
on a disk. 

4. Rename all specified files (Y/N)? Press Y to rename all files in old filespec. 
Press N or RETURN to rename one at a time. 
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5. If renaming one at a time, DOS gives you a Y/N Option on each. 

Press P to print this screen 
Press RETURN for more help 
Press ESC for Help Menu 

After you have read the Help Information, you have to press ESC to return to the 
main DOS 3 menu. Then you may restart the RENAME function. 

HOW TO USE THE SAVE FUNCTION 

This function is cailed from the main DOS 3 menu by typing S. This function is 
generally used by the advanced user who has a need to save machine language 
memory areas for future use. As much as 64K of memory can be saved using a 
single oommand. However, only what might be cailed user-memory should be 
saved. This user-memory is defined in the memory map which is in the appendix of 
this manual, and includes a description of memory areas reserved for the System 
hardware, for the normal System Software, and now used for DOS 3 as well. The 
rest of the memory, designated as user area, may be saved if desired. 

When the S is received by DOS 3, it makes the selection line appear as follows: 

Selection? Save 

Then it highlights the SAVE selection in the menu, and it asks: 

Filespac? 

To this question, the user must respond with a filespec, consisting of a device and 
filename, such as: 

D1:NAME 

or 

D.NAME 

or 

NAME 

All of these examples save a file named“NAME”on disk drive 1. Drive 1 is the 
default in each case, but for this command, some input is required since there is 
no default for the name of the file to be saved. If you wish to Save a memory area 
onto drive 2, then the filename must begin with: D2: 

Or for drive 3: 

D3: and so on. 

The next question asked is: 

Start Addr <HEX)? 

This command asks where, in the current memory, the hexadecimal (base 16) ad¬ 
dress is from which the data is to be saved. The allowable addresses to specify 
here are from hex 0000 to hex FFFF, followed by a RETURN. But as noted above, 
not ali address ranges are practica! to use. Typically a user saves certain memory 
spaces which he has loaded with machine language programs, somewhere in the 
region hex 2000 to about hex BFFF. (Below this region DOS resides, above this 
region, the System hardware and ROM reside.) 

The next question is: 

End Addr (HEX)? 

This DOS 3 response asks for the entry of up to four hexadecimal digits in the 
ränge 0000 through FFFF, followed by a RETURN. 

The ending address must be greater than or equal to the start address. If not, it 
generates an Error 6 - Invalid End Address and refuses to perform the command. 
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The next question is: 

Optional Init Addr (HEX)? 

This asks for an address of a maximum of four hex digits from OOOO to FFFF, then 
expects a RETURN. This address is recorded along with the memory data. When 
this file is again brought into the memory System using the DOS 3 Load command, 
jf this INIT address was specified, the Computer performs a JSR (jui mp to 
subroutine) to this address immediatefy foiiowing the Load. The purpose of this is 
to Initialize something, perhaps to allow proper running of the rest of the program 
(see also Run address below). This does not necessarily mean that the program 
begins immediately after Load. In essence, if the INIT program encäs its task with 
an RTS (return from subroutine), control is returned to DOS 3. 

This INIT address need NOT be within ränge of the memory spa ce which was 
stored on the disk. In fact, often a user might want to bring in a memory segment, 
then use one of the System routines to reinitialize the screen or some other thing 
as the INIT routine. This feature forces a JSR to whatever address the user 
specifjes, if any. 

The next question is: 

Optional RUN addr (HEX)? 

It asks the user to specify up to four hex digits from 0000 to FFFF which is to be 
the RUN address. After the Computer returns control to DOS 3 foll owing the exeou- 
tion of the INIT function (if any), DOS 3 can, if directed to do so, g ive up control of 
the System by executing a JSR (direct JUMP) to this specified RUM address. 

An example is as follows: 

Start Addr (HEX)? 3000 RETURN 

End Addr (HEX)? 3200 RETURN 

Optional INIT addr (HEX)? RETURN 

Optional RUN addr (HEX)? E477 RETURN 

The address E477 is used here as an example only. It is the cold Start System 
reset address. It would not necessarily be logical to bring in a memory segment, 
then to teil the System to go through a cold Start reset. However, 51 may be used to 
demonstrate that the RUN address does indeed cause a jump to t he address 
specified. For reloading instructions, see the section on the DOS 3 Load function. 

IF YOU NEED HELP 

While the Computer is asking you for Information, you may press t he inverse Video 
key or the HELP key to see the foiiowing summary of the SAVE emtry instructions: 

SAVE HELP SCREEN 1 OF 1 

1. Press S to write a selected memory area onto disk. Save worlcs ONLY with 
binary formal programs. 

2. Fiiename? Enter a unique filename. Wildcards are invalid input. 

3. Start addr?/End addr? Enter Start and end addresses In hex. 

4. Optional INIT addr?/Optional RUN addr? Enter address of init program. Enter 
run address to load-and~go. Press RETURN to bypass init and run options. 

Press P to print this screen 
Press RETURN for more help 
Press ESC for Help Menu 

After you have read the Help Information, you have to press ESC twice to return to 
the main DOS 3 menu. Then you may restart the SAVE function. 
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HOW TO USE THE TO-CARTRIDGE FUNCTION 

This function is selected from the main menu by the (etter T. Its purpose is to exit 
DOS, and to enter the cartridge. To make this command function, there must be a 
cartridge present, and you must have entered DOS 3 from the cartridge. To exit 
the cartridge, type: DÖS 

The main System menu appears as usual, with the command (ine specifying: 

Selection? To Cartridcj e 

If you specify a T and there is no cartridge present, the selection menu spells out 
your selection and the error line specifies an Error 4 -no cartridge. 

(f there is a cartridge present, it is initialized, either in the WARM start mode or 
the COLD Start mode. P n a COLD start, all programs the cartridge may have placed 
in memory are erased. f f WARM start mode, the System is restored to its original 
Status betöre DOS 3 was called from that language. 

The primary differencoe lies in whether DOS 3 has run any of its “Utilities” or not. 
The Utilities are selecteof by the options Init, Copy, Dupiicate, Help, or Access DOS 
2. If none of these is used, the WARM start function can be used for the cartridge. 

There are other cons ideraiions to COLD vs WARM start. The advanced user is 
directed to the ATARI Operating Systems Users Manual for more Information. Also, 
other Information may be found in the section titled “How to use the Mem.Sav 
Function.” 

IF YOU NEED HELP 

While the Computer is aisking you for Information, you may press the inverse Video 
key or the HELP key to see the following summary of the To-Cartridge instructions* 

TO-CARTRIDGE HELP SCREEN 1 of 1 

1. Press T to select fur»ction. To-Cartridge passes control from DOS to inserted 
cartridge. 

(a) If BASIC cart. is inserted, the screen displays a READY prompt. 

(b) If ASSEMBLER EOITOR is inserted, screen displays an EDIT prompt. 

(c) If you have not inserted cart., screen displays NO CARTRIDGE. 

2. If you get message (cs), press ESC to return to DOS menu. 

Press P to print this screen 
Press RETURN for more help 

After you have read the Help Information, you have to press ESC to return to the 
main DOS 3 menu. Thert you may restart the To-Cartridge function. 


HOW TO USE THE UNPROTECT FUNCTION 

This function is selected from the main DOS 3 menu by pressing the letter U. It is 
used to modify one or m<ore entries in the file index. Its purpose is to delete the 
protection mark placed o>n a filename by the Protect Function. This allows such 
files to be erased by the System either using the erase utility, or to be replaced by 
any file of the same nam e, or to have anything eise appended to them. Thus the 
name UNPROTECT. 

When this function is selected, DOS 3 highlights the name in the menu area, and 
completes the word opposite the question: 

Selection? Unprotect 

Then DOS 3 asks: 

Filespec? 
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The default reply, if you press RETURN here is: 

Filespec? Dl:*.* 

This means remove the protection from all files on drive 1. You may edit this 
response if you wish, betöre pressing RETURN. If you give a very specific filespec, 
such as: 

D1:COPY.UTL 

In this case, protection is removed only from that file name on the source disk; 
however, if you specify any wildcards, you receive, as the next question: 

Unprotect all specified files (Y/N) N? 

Here, the default reply, No, if you press RETURN, directs the System to ask you 
whether or not to unprotect each file it finds, in turn, matching the wildcard 
filespec you specify. If you change this reply to Y, for Yes, it asks no more ques- 
tions and proceeds to remove protection from all matching filespecs, reporting 
each as it is done. 

Note that the disk you are trying to unprotect must n ot itself be write protected. 
This would prevent the updating of the file index and cause an error. Note also that 
it is not an error to remove protection from an unprotected filename. 

IF YOU NEED HELP 

While the Computer is asking you for information, you may press the inverse Video 
key or the HELP key to see the following summary of the Unprotect entry instruc- 
tions. 

UNPROTECT HELP SCREEN 1 OF 1 

1. Press U to select this function. UNPROTECT erases the protected Status of 
one or more files. 

2. Filespec? Specify files to unprotect. Wildcards can be used. 

3. Unprotect all specified files (Y/N)? Press Y to unprotect all files named by 
filespec. Press N or RETURN to unprotect one by one. 

4. In unprotecting files one at a time, DOS shows you each filename and gives 
you a Y/N Option. Check File Index. Unprotected files lose the (*) in front of 
filename. 

Press P to print this screen 
Press RETURN for more help 
Press ESC for Help Menu 

After you have read the Help information, you must press ESC to return to the 
main DOS 3 menu. Then you may restart the Unprotect function. 


HOW TO USE THE X-USER-DEFINED FUNCTION 

This function is for the advanced user, in connection with a machine langua.ge pro¬ 
gram which has been Saved using the DOS 3 SAVE function. It is called by typing 
the letter X from the main DOS 3 menu. 

On selecting the X-function, DOS 3 completes the ph rase X-user-defined op- 
posite the word Selection, and highlights this selection in the menu area. Then it 
asks: 

External command? 

The external command is the name of a file with the th ree letter extension' ‘ .CMD”. 


53 



You must have previously Saved a file with a name like this in Order to use this 
command. For example, if you had saved a file on the disk using the DOS 3 SAVE 
command, titled: 

MYOWIM.CMD 

And then when DOS 3 asks: 

Externa! command? 

You specify: 

MYOWN 

And press RETURN. 

DOS 3 then responds: 

Loading Dl :M YOWN.CMD ... 

And automatically executes it once it has been loaded. 

This command is similar to the DOS 3 LOAD command. The difference is that 
for each file matching the filespec, DOS 3 asks if it should execute the file once it 
has been loaded. Then it goes on to try to match other file names to the filespec, 
asks if it should load each, then asks if it should execute each. 

If you do not specify any file name when it asks about the external command, 
pressing RETURN results in DOS 3 searching the disk and presenting to you one 
at a time each file name which has the .CMD extension. On the foliowing line then, 
it presents the prompt: 

Execute this command file (Y/N)? N 

Note the default reply, No, is already present. If you just press RETURN at this 
point, it continues the search, presenting each CMD file as it finds it. When you 
find the one you want to RU N, then change the N to a Y before pressing RETURN. 

This has the same effect as using the DOS 3 LOAD command and requesting 
that this file IS to be run. 

When it ruims out of entries in the directory with the CMD as an extension, it 
reports, on the Information line: 

No more matches 

Once a file has been loaded in this manner, because it will auto-execute, control is 
given to the Ti le and not to DOS 3. To return control to DOS 3 (providing that the 
file does not imterfere with memory in use by DOS 3), control may be returned to 
DOS by executing an RTS at the end of the file execution. Thus, these can truly be 
user-defined extensions to the DOS structure. 

IF YOU NEED HELP 

While the Computer is asking you for Information, you may press the inverse 
Video key or the HELP key to see the foliowing summary of the X-User-Defined 
entry instructi ons: 

User-Defined Help Screen 1 of 1 

1. Press X to select a program you have written in assembly language and 
stored with SAVE. 

2. After pressing X, you can (a) type in filespec and press RETURN or (b) press 
RETURN and let DOS show filenames on Dl: with CMD extenders. If method 
(b) is used, press X with your program disk in drive 1. 

After DOS loads in the command file, you may remove your program disk. 

Press P to print this screen 
Press RETURIM for more help 

After you have read the Help information, you have to press ESC to return to the 
main DOS 3 menu. Then you may restart the X-user-defined function. 
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MORE USER 
INFORMATION 



BASIC COMMANDS USED WITH DOS 

Before describing the BASIC commands used with DOS 3, you need to know how 
the commands act on programs being stored and retrieved. The foll owi ng 
paragraphs explain the two types of files that can hold BASIC programs. 


TOKENIZED AND UNTOKENIZED FILES 

The first type of file, called “untokenized,” contains Standard ATASCII text 
characters so it looks like a printout of a BASIC program. These programs do not 
retain their Symbol tables each time they are loaded and saved. The symbol table 
associates the variable name with the memory location where the values for that 
variable are stored. To störe and retrieve a file in its untokenized form, you use the 
LIST and ENTER commands. 

The second type, calied a “tokenized“ file, is a Condensed version of a BASIC 
program. It has one-byte “tokens” instead of the ATASCII characters to represent 
the BASIC commands. 

Tokenized programs are moved back and forth between the disk drive and the 
Computer console by SAVE and LOAD commands. Tokenized versions of a file are 
generally shorter than untokenized versions. For this reason, many programmers 
prefer to störe their final programs in the tokenized form because th ey load faster 
and use less disk space. A tokenized version retains its symbol table f rom retrieval 
to retrieval. 

LOAD (LO.) 

Format: LOAD filespec 

Example: LOAD "Dl: DOSDEMO.BAS M 
RETURN 

This command is used to load a file from a particular diskette in a d5sk drive into 
the user program RAM area. To use this command to load a file caöl ed 
DOSDEMO.BAS, the file (DOSDEMO.BAS) must have been previously saved using 
the BASIC command, SAVE. This command only loads a tokenized version of a pro¬ 
gram. 

This command can also be used in “chaining" programs. If you have a program 
that is too big to run in your available RAM, you can use the LOAD command as 
the last line of the first program. Therefore, when the program encounters the 
LOAD Statement, it automatically reads in the next part of the program from the 
diskette. However, the second program must be able to stand alone without depen- 
ding on any variables or data in RAM from the first program. The loaded program 
does not execute until you type RUN RETURN, at which time the prevnous pro 
gram and any variables are cleared (see RUN for another example). Thie following 
is an example of program chaining: 

31100 REMChain program 
31200 LOAD “Dl CHAIN.BAS” 


SAVE (S.) 

Format: SAVE filespec 

Example: SAVE “Dl:EXAMP2.BAS- 

RETURN 

This command causes the Computer system to save a program on diskette with the 
filespec name designated in the command. SAVE is the complement of LOAD and 
Stores programs in tokenized form. 

LIST (L.) 

Format: LIST filespec .lineno .lineno device 

Example: LIST “D: DATEIL.LST” 

LIST “P:” 

LIST “P:”, 10, 100 

One use of the LIST command in BASIC is very similar to the SAVE command as it 
can take a program from user program RAM and störe it onto a particular drive 
with any name you want to assign it (illustrated by the first example). However, the 
program is stored in Standard ATASCII text and not as tokens. Differences in the 
formatting of data storage also allow LIST to be much more flexible than SAVE. As 
shown in the above format examples, you can specify a single device (e.g., p;, e.\ 

C„ D:, D2:, etc.), or you can specify line numbers to be listed to a designated 
device (e.g., “P:”, 100, 200). 

If you do not specify a device after the LIST command, any line numbers you 
enter are dcsplayed on the screen. The screen (E.) is always the default device for 
this command. 

In summary, the Principal difference between LIST and SAVE isthat LIST moves 
Standard A T ASCII text to a number of different devices whereas SAVE can only 
save tokenized BASIC programs on a diskette. 

Because files placed on the diskette with LIST are not tokenized, you may, if you 
wish, use the DOS 3 COPY command to copy from a LISTED file to the printer. 

See the COPY function for more Information. 

ENTER (E.) 

Format: ENTER filespec 

Example: ENTER “D: LIST2.LST" 

This command causes the Computer to move a file on diskette with the referenced 
filespec into RAM. The program is entered in untokenized form and is interpreted 
as the data is received. ENTER, unlike LOAD, does not destroy a RAM-resident 
BASIC program, but merges the RAM-resident program and the disk file being 
loaded. If there are duplicate line numbers in the two programs, the line in the pro¬ 
gram being entered replaces the same line in the RAM-resident program. 

RUN 

Format: RUN filespec 

Example: RUN “D2: MYFILE.BAS" 

This command causes the Computer to LOAD and RUN the designated filespec. It 
is a combination of the two commands, LOAD and RUN. However, the RUN com¬ 
mand can on Iy be used with tokenized files. Therefore, you cannot execute a RUN 
"D2: LIST.LST”command. 
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To Chain programs and cause a second Segment ot a file to load and run 
automatically, you can use a RUN “D: filespec”as the last line of the first segment 
However, the second program must be abie to stand alone without depending on 
any variables or data in RAM from the first program. Betöre running the first seg¬ 
ment, make sure you have saved it on a diskette, as the RUN Statement wipes out 
your RAM-resident first segment when the second segment is loaded. 


INPUT/OUTPUT CONTROL BLOCKS 

An I/O Operation is controlled by an I/O Control Block (IOCB). An IOCB is a 
specification of the I/O Operation, consisting of the type of I/O, the buffer length, 
the buffer address, and two more auxiliary control variables of which the second is 
usually 0. ATARI BASIC sets up eight lOCBs and dedicates three to the following: 

■ IOCB #0 is used by BASIC for I/O to E: (the screen editor) 

■ IOCB #6 is used by BASIC for I/O to S: (the screen display Controller) 

■ IOCB #7 is used by BASIC for LPRINT, CLOAD, and SAVE commands. 

IOCB #1 through #5 can be used freely, but the dedicated lOCBs should be avoid- 

ed unless a program does not make use of one of the dedicated uses mentioned 
above. IOCB #0 can never be opened or closed from a BASIC program. 


lOCBs WITH INPUT/OUTPUT COMMANDS 

Each input/output command must have an IOCB associated with it. The I/O com- 
mands that can be used in connection with DOS 3 are the following: 

OPEN/CLOSE 

INPUT/PRINT 

PUT/GET 

STATUS 

XIO 


USING THE OPEN/CLOSE COMMANDS 

OPEN (O.) 

Format: OPEN #iocb, aexpl, aexp2, filespec 

Example: 100 OPEN #2, 8, 0, “Dl: ATARI800.BAS“ 

The OPEN Statement links a specific IOCB to the appropriate device handler, in- 
itializes any ClO-related control variables (see Glossary), and passes any device- 
specific options to the device handler. The Parameters in this Statement are 
defined in the following: 

# Mandatory character entered by user. 

iocb A number between 1 and 7 that refers to a device or file. 

aexpl Number that determines the type of Operation to be performed. 

Code 4 = input Operation; positions file pointer to Start of file. 

6 = disk directory input Operation. 

8 = output Operation; positions file pointer to Start of file. 

9 = end-of-file append Operation; positions file pointer to end of 

file. Code 9 allows program input from screen editor without 
user pressing RETURN. 


12 = input and output Operation; positions fiie pointer to Start of 

file, not possible to write past EOF. 

13 = Input and Output Operation; positions file pointer to EOF; 

writing past EOF is allowed. 

aexp2 Device-dependent auxiliary code. An 83 (ASCII S) in this position causes 
the ATARI 820™ Printer to print sideways; otherwise it is always 0 (zero). 
filespec Specific file designation (see Section 1 for filespec definition). 

In the example, OPEN #2, 8, O f “D1: ATARI800.BAS”, IOCB #2 is opened for output 
to a file on Drive 1 designated as ATARI800.BAS. If there is no file by that name in 
Drive 1, the DOS creates one. If a file by that name already exists, the OPEN State¬ 
ment destroys that file and creates a new one. If the IOCB has already been open¬ 
ed, the screen displays an ERROR-129 (IOCB Already Opened). 

CLOSE (CL.) 

Format: CLOSE #iocb 

Example: 300 CLOSE #2 

The CLOSE command releases the IOCB that had been previously opened for 
read/write operations. The number following the mandatory # must be the same as 
the IOCB reference number used in the OPEN Statement (see example below). If 
the IOCB has already been opened to one device and an attempt is made to open 
the same I OCB to another device without closing, the first ERROR-129 displays on 
the screen . The same IOCB cannot be used for more than one device at a time. 

You do not get an error message if you close a file that has already been closed. 
The following is an example of opening and closing a file: 

10 OPEN #1,8, 0,“D: FIL.BAS” 

20 CLOSE m 

Note: The END command closes all open files (except IOCB #0). 


USING THE INPUT/PRINT COMMANDS 

INPUT (I.) 

Format: , avaravar 

INPUT #iocb ; svar , svar ... 

Examples: 100 INPUT #2; X, Y 
100 INPUT #2; N$ 

This command is used to request data (either numerical or String) from a specified 
device. IN PUT is the complement of PRINT. When used without an #IOCB, the data 
is assumed to be from the default device (E:). INPUT uses record I/O (see PRINT). 
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The following is an example of an INPUT/PRINT program: 

10 REM *CREATE DATA FILE* 

20 REM *OPEN WITH 8 CREATES DATA FILE* 

30 OPEN #1 t 8,0,”D:WRITE DAT” 

40 DIM WRT$(60) 

50 ?”ENTER A SENTENCE NOT MORE THAN 60 CHARACTERS.” 

60 INPUT WRT$ 

70 REM *WRITE DATA TO DISKETTE* 

80 PRINT #1; WRT$ 

90 REM *CLOSE FILE* 

100 CLOSE #1 

110 REM *OPEN DATA FILE FOR READ* 

120 REM *OPEN WITH 4 IS A READ ONLY* 

130 OPEN #1,4,0,”D:WRITE.DAT” 

140 REM *READ DATA FROM DISKETTE* 

150 INPUT #1 ,WRT$ 

160 REM * PRINT DATA • 

170 PRINT WRT$ 

180 REM *CLOSE DATA FILE* 

190 CLOSE #1 

In the example above, line 60 allows the user to type in data on the keyboard 
(default device). In Line 150, the INPUT Statement reads the contents of the string 
from the opened file. 

PRINT {PR. or ?) 

Format: PRINT #iocb ; [exp]... [exp] 

Examples: 100 PRINT #2; X, Y 
100 PRINT #2; A$ 

100? C$ 

100 PR!NT‘‘X = ”,X 

This command writes an expression (whether string or arithmetic) to the opened 
device with the same IOCB reference number. If no IOCB number is specified, the 
System writes the expression to the screen, whieh is the default device. If the i nfor- 
mation is directed to a device that is not open, ERROR-133 displays on the screen. 
PRINT performs what is called record I/O. Records are sets of bytes separated by 
end-of-line characters (9B Hex). The size of a record is arbitrary. Record size can 
be determined by the length of a string printed to a diskette file or the format of an 
arithmetic variable. It can also be the length of a string of characters entered f rom 
the keyboard and terminated by RETURN. 

The INPUT Statement cannot (generally) read a record that is longer than 1 1 O 
characters in length. If you PRINT a record to the disk that you later want to 
INPUT, it is best to limit the size of the PRINTED reoords to 110 characters or Hess. 
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DIRECT ACCESSING WITH THE 
NOTE/POINT COMMANDS 

NOTE (NO.> 

Format: NOTE #iocb,avar,avar 

Example: NOTE #2,A,B 

Files are created sequentially and are normally accessed from beginning to end. In 
other words, when you create a data file, each record may have been placed in 
the file by some form of PRINT Statement. As an example, there may be a file 
named “STUDENT. DAT” in which there are 200 “records” (specific groupings of 
data). If you wanted to read only record numbers 25, 120 and 190, the normal se- 
quential access method would take a long time. The sequential method means to 
have an INPUT Statement in a loop reading each one of the records in sequence, 
ignoring each one until it counts up to the one you really wanted to read. 

The Situation would be even worse if you needed the records in a truly random 
manner. The sequential example above would have required 190 disk reads before 
you would toe able to get all the data you wanted. If, instead of the above sequence 
you wanted them in the order 190, 120, 25, you might have been required to reset 
the file poin ter to the beginning EACH time, then to count up to the record you 
wanted. Thi s would required 190 + 120 + 25 or 335 disk reads. 

To elimin ate such delays in nonsequential file access, the NOTE command is us- 
ed to “make a note” of where in the file each individual record is stored. Later 
then, using the POINT command, the file pointer can be placed directly on the 
desired record, allowing immediate access by a single read instead of the multiple 
read required in the example described above. This is called random file access. 

The following program sample below, called NOTETEST, demonstrates the use 
of the NOTE command. DOS 3 treats all files as a sequence of data bytes. This se¬ 
quence beg ins with the first byte, labeled as byte “0", with each subsequent byte 
at Position di ,2, 3 etc. The value of the first “avar” (in the example program, this is 
the variable X) represents the value of the current pointer to the file. That is, where 
in the file the next byte is be stored. This means that in a file freshly opened, this 
value is 0. 

The seco nd “avar“ (in the sample program, Y), is meaningless in DOS 3 but 
MUST BE P RESENT. This is because ATARI BASIC was written for compatibility 
with DOS 2 initiallv- See the section called “Differences between DOS 3 and DOS 
2” for more Information. When you RUN the sample program NOTETEST, you can 
type in a nu mber of lines, each with 40 characters or less. When you press 
RETURN with no characters on a line, the files are closed and the program ends. 
This builds sl pair of files for the POINTEST program. The comments in the program 
teil you how’ it works. 

10 REM NOTETEST DEMO 

20 REM CREATES A POINTER FILE 

30 REM FOR DOS 3 RANDOM ACCESS 

40 DIM A$(-40):COUNT = 0 

50 OPEN #1 ,8,0,‘'D:DATFIL. DAT” 

60 OPEN #2,8,0,“D:POINTS.DAT” 

70 REM IN PUT 40 OR LESS CHARACTERS 
80 INPUT AS 

90 REM IF RETURN ONLY, THEN STOP 
100 IF LEN(A$)= O THEN 250 


60 



110 NOTE #1 ,X,Y:REM ONLY X IS SIGNIFICANT 
120 REM STORE LINE OF DATA 
130 PRINT #1;A$ 

135 COUNT = COUNT + 1 :IF COUNT =100 THEN GOTO 250 

140 REM STORE POINTER TO BEGINNING 

150 REM LINE OF DATA 

160 REM DOS 3 REQUIRES ONLY ONE 

170 REM PARAMETER 

180 PRINT #2,X 

190 REM DISPLAY OFFSET TO DATA 

200 REM LINES ON SCREEN 

210 PRINT “OFFSET = ”;X 

220 REM NOW INPUT NEXT RECORD 

230 GOTO 80 

240 REM INDICATE END OF FILE 
250 PRINT #2,-1 
260 END 

P01NT(P.) 

Format: POINT #iocb, avar, avar 

Example: 100 POINT #2, A, B 

POINT is the complement of NOTE. This command sets the file pol nter to an ar- 
bitrary value determined by the arithmetic variables. POINT is usecd when reading 
or writing specified file locations (sector and byte) into RAM or to cdisk. The first 
arithmetic variable specifies (points to) the next byte number into whioh the next 
byte is read or written. If you point out of an opened file, you get s File Number 
Mismatch error message. The following program listing and samplee run that follow 
it contain an example of the POINT command to read data createcd by the program 
shown as the example for the NOTE command. 

When run, this program allows the user to choose a record to dHsplay. 

10 REM POINTEST DEMO 
20 REM THIS PROGRAM READS 
30 REM THE FILES CREATED 
40 REM BY POINTEST AND ACCESSES 
50 REM THE RECORDS RANDOMLY 
60 DIM A$(40) 

70 DIM X(100):Y = 0:LAST = 0 
80 REM OPEN DATA FILE 
90 OPEN #1 ,4,0,"D: DATFIL.DAT” 

100 REM OPEN POINTER FILE 
110 OPEN #2,4,0,“D:POINTS.DAT” 

120 REM READ POINTERS INTO AN ARRAY 

140 INPUT #2,P:IF P < >-1 THEN LAST = LAST + 1 :X(L7\ST) = P:GOTO 140 
180 REM INPUT RECORD NUMBER TO DISPLAY 
185 TRAP 320 

190 PRINT "ENTER RECORD NUMBER TO DISPLAY” 

200 INPUT R 
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205 IF R < 1 THE UM GOTO 280;REM END PROGRAM 

210 IF R > LAST HTHEN PRINT “RECORD DOES NOT EXIST“:GOTO 190 

220 REM ACCESS RECORD RANDOMLY 

230 POINT #1 ,X(R>,Y 

240 INPUT #1 ;A$ 

250 PRINT A$ 

260 GOTO 1 80 

280 PRINT “END OF EXECUTION , ’ 

290 CLOSE #1 :C L OSE #2 
300 STOP 

320 TRAP 40000:C3OT0 185:REM IF INPUT ERROR CONTINUE INPUT 


USING THE PUT/GET COMMANDS 

PUT (PU.) 

Format: PUT ^HocLaexp 

Example: 100 P CJT #6, ASC (”A’ ! ) 

The PUT comnrr ond writes a single byte (value from 0-255) to the device 
specified by the ICDCB reference number. In Figure 5-1 the PUT command is used 
to write each num ber you type into an array dimensioned as B(50). You can enter 
up to 50 numbers , each of which should be less than 256. This command is used 
to create data file s or to append data to an existing file. 

The sample program shown below is split into two parts. The first part 
demonstrates PUT, and is shown here. The second part demonstrates GET and is 
contained under t he GET heading. In the example for GET, rather than sense an 
end-of-file (TRAP o>n error) to determine the end of the data, bytes 0 and 1 of the 
file itself have bee n used as a counter of the number of bytes in the file. 

1 0 GRAPHICS 0: R EM PUT/GET DEMO 
20 DIM A(50),A$(T O) 

30 GRAPHICS 0:? ' ‘PUT AND GET TO DISK PR 
OGRAM EXAMPLE”:? 

40 ? “Is this to be a READ or a WRITE?”: 

IN PUT A$:? 

50 IF A$ = “READ TTHEN 170 

60 IF A$< > ‘WRITE” TH EN PR I NT “?”:GOTO 40 

70 REM WRITE ROUTINE 

80 OPEN #18,0/ ‘EDI :EXAMiPL1 .DAT” 

90 ? “Enter a nurrmber less than 256”:INPUT 
X 

95 REM **WRITE NUMBER TO Fl LE** 

100 PUT #1,X 

1 1 0 IF X = 0 THEFsD CLOSE #1 :GOTO 130 
1 20 GOTO 90 

Figure 5-1 Sample F^UT Program 


GET (GE.) 

Format: GET #iocb, avar 

Example: 100 G ET #2, X 

This command reads a single byte from the device specified by the IOCB 
reference number into the specified variable. The second part of the program ex¬ 
ample (Figure 5~2> iliustrates the GET command. It ailows you to retrieve each byte 
stored by the PUT“ command. 
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130 GRAPHICS 0:?:? “Read data in file n 
ow?”:INPUT A$? 

140 IF A$= “NO“ THEN END 
150 IF A$ < > “YES“ THEN 130 
160 REM READ OUT ROUTINE 
170 OPEN ,4,0,"Dl: EXAMPL1.DAT" 

180 FOR E = 1 TO 50 

185 REM **READ NUMBER(S) FROM FILE** 

190 GET #2,G:A(E) =G 
200 IF G= 0 THEN GOTO 230 
210 PRINT “BYTE #”,E;“ = M ;G 
220 NEXT E 
230 CLOSE #2 

Figure 5-2 Continuation of the PUT/GET Demo 

Note that INPUT/PRINT and GET/PUT are incompatible types of INPUT/OUTPUT. 
PRINT inserts end-of-line (EOL) characters between records and INPUT uses them 
to determine a record. GET and PUT merely write single bytes to a file witfhout 
separating them with EOL. A file created by using PUT Statements looks like one 
large record unless you have placed an EOL (9B Hex) character into the fi le. 

After you have typed the sample PUT/GET program, type RUN RETURN. 

When you run the program shown in Figure 5-2 it prints the numbers enlered 
from the keyboard together with the byte numbers in which each was stored. 

After you type the program, type RUN RETURN using number entries 2, 5, 67, 
54, 68. 


BYTE #1 = 2 
BYTE #2 = 5 
BYTE #3 = 67 
BYTE #4 = 54 
BYTE #5 = 68 

Figure 5-3. Sample Run of The PUT/GET Program 


USING THE STATUS COMMAND 

STATUS (ST.) 

Format: STATUS #IOCB, avar 

Example: 100 STATUS #5, ERROR 

The STATUS command is used to determine the condition (state) of a file. This 
command is a CIO command and checks for several ways an error occurs. The 
first set of possible errors it checks for is as follows: 

System buffer available? If no, then ERROR-161 
Legal device number? If no, then ERROR-160 
Legal filename? If no, then ERROR-165 

File on diskette? If no, then ERROR-170 

File protected? If yes, then ERROR-167 


CO 


You can also id entify all I/O serial bus errors with a STATUS command These are 
as follows: 


Device timeout 

Device not acknowledged 

Serial bus error 

Serial bus data Trame overrun 
Serial bus checi-csum error 
Device done 


ERROR-138 
ERROR-139 
ERROR-140 
ERROR-141 
ERROR-142 
ERROR-144 


To use this com mand, you must open the file as an input-only file then Hn^o t hQ 
file. Only then can you issue a STATUS command. 

Figure 5-4 allows you to check the Status of your disk drive with a TRAP state 
ment. Betöre running the program, turn off your disk drive. 


10 GRAPHICS 0:REEM TRAP/STATUS DEMO 
20 DIM A(50),A$( 10),D$( 1) 

30 GRAPHICS 0:?“^ PUT AND GET TO DISK PR 
OGRAM EXAMPLE ”:? 

40 ? “Is this to be 3. READ or a WRITE?”: 

INPUT A$:? 

50 IF A$ = “READ' ’ THEN 160 

60 IF A$ < > "WFRITE” THEN PRINT "?”:GOTO 40 
70 REM WRITE RO UTINE 

80 TRAP 400:OPENJ #1 , 8 , 0 , "Dl :EXAMPL1 .DAT” 

90 ? “Enter a nurnder less than 256’ ’.INPU 
TX 

100 PUT #1,X 

110 IFX = 0 THEN GLOSE #1:GOTO 130 
120 GOTO 90 

130 GRAPHICS 0:7 :? “Read data in file n 
ow?”:INPUT A$:? 

140 IF A$ = “NO” THEN END 

150 IF A$ "YES” THEN 130 

160 REM READ OUT ROUTINE 

170 TRAP 400:OPEhsf #1,4,0,"Dl:EXAMPL1 .DAT 

180 FOR E = 1 TO 50 

190 GET #1 ,G:A(E) = G 

200 IFG = 0 THEN GOTO 230 

210 PRINT “BYTE #-”;E;“ =”;G 

220 NEXT E 

230 CLOSE #1 

240 END 

400 TRAP 40000:STATUS #1,ST:IFST < >138A 
ND ST< >139 THEN PRINT “HELP”:? ST.GOTO 4 
30 

410 ? “Is your disk drive turned on?" 

420 ? “Type Y if you: turned on the disk 
drive.";: IN PUT D$ 

430 CLOSE #1 :GOTO 40 


Figure 5-4 Sample Status Program 
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OTHER COMMAND NUMBERS USED BY DOS 3 

The following command numbers are used internally to DOS 3. They 
could be specified as part of an XIO command. However they would 
be meaningless in that there is no place within the command to 
specify or to accept a variable which is normally passed to the Stan¬ 
dard form of the command. Therefore, these nonstandard forms can- 
not be used and the normal BASIC command must be used instead. 


Command # 

TYPE 

Equivalent BASIC Command 

XIO 5 .... 

Get record 

INPUT#1 A.B.C or INPUT FS 

XIO 7 .... 

Get character 

GET#1 ,A 

XIO 9 .... 

Put record 

PRI NT#1 A.B.C or PRINT FS 

XIO 11 ... 

Put character 

PUT#1,A 

XIO 37 ... 

Point 

POI NT#1 ,X,Y 

XIO 38 ... 

Note 

NOTE#1 ,X,Y 

XIO 39 ... 

Get directory 
entry 

INPUT#1,FILES (see example) 

XIO 40 ... 

Rename a 
filespec 

There is no functiona! equiValent. 
DOS 3 uses it internally to oonvert a 
wildcard filespec into a real one. 


PROGRAM EXAMPLE OF XIO COMMAND USES 

Figure 5-5 allows you to create a file for each month of the year into whiclhi you 
can enter the names and birthdays of your family and friends. The program uses 
XIO Statements to create a file for each month, to lock and unlock each filo as 
needed by the program, and to close the file when you are through with it. 

Line 20 defines the disk file D: BIRTHDAY as FI LE$. Then in Line 170, FI LE$ is 
opened with a XIO Statement for input. The XIO Statement in Line 390 unlocks the 
proper file. The XIO Statement in Line 400 creates the file and allows you to write 
to the file. The next XIO Statement, in Line 430, closes the file and the next line’s 
XIO Statement locks the file to prevent it from being accidentally overwritten or 
erased. 

5 GRAPHICS 0 

10 D1M A$(5),D$(15),FILE$(20),DATE$(20), 

MON$(20),ERR$(20),NAME$(40) 

20 FlLE$ = “D:BIRTHDAY.’’ 

30 ERR$ = “ERROR IN MONTH #” 

100 GRAPHICS 0:? “PLEASE TYPE MONTH NUMB 
ER (1-12)“ 

110 TRAP 100:1NPUT MONTH 

120 TSTEND = 0 

130 MONTH = INT(MONTH) 

140 IF MONTH 1 OR MONTH 12 THEN ? ERR$:G 
OTO 100 

145 GOSUB 1000 + MONTH 
150 FlLE$(12) = STR$(MONTH) 

160 EOF = 0 

170 TRAP 700:XIO 3,#2,4,0,FILE$ 

180 TRAP 600:FOR I = 0 TO 1 STEP 0 
190 INPUT #2;NAME$ 

200 IN PUT #2;DATE$ 

210 EOF = EOF + 1 

220 IF EOF = 1 THEN ? “BIRTHDAYS IN “;MON$ 

;“ARE:”:? 

224 TEMP= LEN (NAME$) 

225 NAME$(TEMP + 1) = “ ” 

Figure 5-5. Sample XIO Program 
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226 NAME$(30)=“ ” 

227 NAME$(TEMP + 2,30) = MAME$(TEMP + 1) 

230 ? NAME$,DATE$ 

240 NEXT 

299 REM MKE NEW ENTRIES IN BIRTHDAYS 

300 ? “WOULD YOU LIKE TO MAKE A NEW BIRT 

HDAY ENTRY":INPUT A$ 

310 IF A$ > <“YES”THENi GOTO 20 
320? "PLEASETYPE PERSONS NAME” 

330 IN PUT NAME$ 

340 ? “PLEASE TYPE PERSONS BIRTHDAY (MM- 
DO-YY)” 

350 INPUT DATE$ 

360 MONTH = INT{VAL(DATE$)) 

370 IF MONTH < 10R MONTH > 12 THEN ? ERR$,D 

ATE$:GOTO 300 

380 FILE$(12) = STR$(MONTH) 

390 TRAP 400:XIO 36,#3,0,0, FILE$:OPEN # 

,9,0,FILE$:GOTO 410 

400 CLOSE #2:XIO 3, #2,8,0, FILES 

410 PRINT #2;NAME$ 

420 PRINT #2;DATES 
430 XIO 1 2,#2,0,0,FILES 
440 XIO 35,#2,0,0,FILES 
450 GOTO 300 

600 CLOSE #2:IF EOF = 0 THEN ? "NO BIRTHDA 
YS IN ”;MON$ 

610 MONTH = MONTH + 1 

620 IF MONTH 12 THEN MIONTH = 1 

630 TSTE N D = TSTE N D + 1 

640 IF TSTEND = 1 THEN GOTO 145 

650 GOTO 300 

700 EOF = 0;GOTO 600 

1001 MON$ = ‘'JANUARY”: RETURN 

1002 MON$ = “FEBRUARY”: RETURN 

1003 MON$ = “MARCH”:RETURN 

1004 MON$ = "APRIL’’:RETURN 

1005 MON$ = "MAY'':RETURN 

1006 MON$ = ''JUNE”:RETURN 

1007 MON$ = "JULY”:RETURN 

1008 MON$ = “AUGUST':RETURN 

1009 MON$ = “SEPTEMBER’ ’.'RETURN 

1010 MON$ = “OCTOBER ”: RETURN 

1011 MON$ = “NOVEMBER ” :RETURN 

1012 MON$ = “DECEMBER " :RETURN 

3000 FILE$(12,12+LEN(STR$(MONTH)))=STR$ 
MONTH):? FILES 


Figure 5-5 Sample XIO Prc»gram(Cont.) 


When you run this program, enter a number from 1 to 12. The program checks to 
see whether or not there are any entries in the fite. If there are none, the screen 
displays the message NO BIRTHDAYS IN followed by whatever mont'h you 
selected. If you have made entries, the screen displays the names of the people 
and their birthdays for the month. In either event, the screen displays the names 
and birthdays for the month you selected and the succeeding month (as a failsafe 
feature so you do not forget an important birthday that comes at the first part of 
the next month), When you do not wish to see another file or make another birth¬ 
day entry, type NO to each prompt message and the program ends. 
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SUBSTITUTING THE XIO COMMAND FOR 
DOS MENU OPTIONS 

XIO (X.) 

Format: XIO cmdno, #iocb, aexpl, aexp2, filespec 

Example: 100 XIO 3, #6, 4, 0,“D: TEST.BAS” 

The XIO command is a general INPUT/OUTPUT Statement used for special opera- 
tions. It is used when you want to perform some of the "functions that would other- 
wise be performed using the DOS menu selections. Note that XIO calls need 
filespecs. The various operations possible using XIO wit h DOS 3 are summarized 
below. 

CMDNO (command number) is used to designate just which of the operations is to 
be performed. 

CMDNO OPERATION EXAMPLE 

3 OPEN XIO 3, , 4, 0,“D:TEST.DAT” 

This command functions exactly like the OPEN command, explained 
earlier. It opens a file for read operations (parameter shown as a 4 above). 
Equivalent to the command 
OPEN #1,4,0,”D:TEST.DATA M 

12 CLOSE XIO 12, m, 0, 0,“D:TEST.DAT” 

This command is equivalent to the command CLOSE #2. Therefore this 
form of the close command is seldom used. 

32 RENAME XIO 32, #1, 0, 0,“D:OLD, NEW'' 

This command allows you to rename a file on the disk without calling the 
DOS 3 menu. The first part of the filespec is D :OLD which consists of the 
complete filespec for the old source file name which is to be changed. 
Other examples for this part are: 

D1:OLDNAME.BAS 
FORMER.NAM (assumes unit 1) 

The second part of the filestring is separated from the first by a 
comma. In this example, it is the name KIEW. Note that when you 
use this form, you do NOT specify a unit number after the comma. 
The file is renamed on the disk on which the old filespec is made. 

The effect of the command is identical to that of calling the DOS 3 
main menu and executing the RENAME file command. 

If you use wildcards in the source filespec, the Rename occurs with the 
first file (starting at the beginning of the file incdex) which matches the 
filespec. If there are more than one file which matches this filespec, an 
error 174 occurs. 

Note that when an IOCB is selected for any one of these special DOS- 
from-BASIC Operation, it must not already be in use for another kind of 
Operation, such as an IOCB opened for a file read or write. For each of 
the commands shown below, the IOCB is usecd, then is free for further use 
after command completion. This is in contrast to the OPEN command 
which ties up the IOCB until the file is closed or the program ends (which 
automatically closes open files). 
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33 ERAXSE XIO 33, #1,0, 0,“D2:JUNK.BAS” 

Th 6 s command, used from BASIC, causes the deletion of the file matching 
thes filespec and has the same effect as calling the ERASE function from 
the DOS 3 menu. If there is no file on the selected disk matching the 
file spec, then an error 170 (file not found) is generated. 

Will cdcard may be used, such as: 

XIO 33,#1,0,0,”D2:J*.*” 

whlch has the result of erasing all files that match the filespec. 

34 VAB_lDATE FILENAME XIO 34, #1,0,0, F$ 

This command can be used to find out if a specified name is of a valid 
form. It would normally be followed by a STATUS command, as: 

STATUS #1,A 

If tB—i e file name is not valid, the variable A is set to 130 (nonexistent 
devn ce), 160 (device number error), or 165 (filename error). If the file name 
is v^alid, the Status is set to 1. Wildcards may be used in the filespec. 

35 PRCDTECT XIO 35, #1,0, 0,‘‘D:PRECIOUS” 

36 UN R’ROTECT XIO 36, #1, 0, 0”D:OKWRITE.FIL” 

These commands are the exact equals of the PROTECT and UN PROTECT 
fun<G=tion calls from the main DOS 3 menu. The result is the same. 

41 LOAD A FILE XIO 41 ,#1,0,0,”D2:LOAD.FIL” 

This has the same effect as calling the LOAD function from the main DOS 
3 menu. The INIT address, if any, is executed as is the RUN address. If 
the ffile which is loaded does not affect any of the space which is being 
used by BASIC, an RTS at the end of the INIT part returns control to 
BAS IC. This function is for the advanced user. 

253 FOFR MAT ANY DISK 

For ithe 810, this command is: 

XIO 253,#1,33,87, ”D2:” 

(or whichever unit to be done) 

For the 1050 single density: 

XIO 253,#1,33,87,’ ’D2:”(same as 810) 

For the 1050 double density: 

XIO 253,#1,33,127,”D2:” 

Both the 810, and the 1050-single density mode format 720 sectors 
on the disk. The command byte 87 above (aux2) represents the 
result of the formula (720-24)/8. 

The 1050, in double density mode is formatted with 1040 sectors 
Thus, the aux2 command byte is (1040-24)/8, or 127. 

254 FOFRPV1AT AN 810 DISK 

XIO 254,#1,0,0,”D2.” 

In thif s case, the auxl, and aux2 bytes are ignored. The selected unit is 
told to format a disk in the 810 mode. 
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ACCESSING DAMAGED FILES 

There are two types of damaged files: 

1. The disk directory entry, which contains the file name, directory pointer (points 
to the first sector of the file), and the number of sectors in the file. 

2. The file itself. 

Should the DISK DIRECTORY entry be damaged, there is no way to access the file. 
If the DISK DIRECTORY entry was accidentaliy deleted, FMS reports ERROR 1 70 
(File Not Found). If the number of blocks indicated in the DISK DIRECTORY entry 
do not coincide with the actual number of blocks in the file, FMS reports ERROR 
177 (Disk Structure Damage). In this latter case, you may be able to retrieve a Por¬ 
tion of the file by initiating the Get Byte program in Figure 5-6. 

READY 

10 OPEN #1,4,0, M D:FILE.1” 

20 OPEN #2,8,0,”D:FILE.2” 

25 TRAP 50 
30 GET #1 ,A 
40 PUT #2,B 
45 GOTO 30 
50 CLOSE #1 
60 CLOSE #2 

Figure 5-6 Get Byte Program 

Let us say File 1 = the damaged file, and File 2 = the recovery file. Note: You 
can only read the sectors that fall BEFORE the damaged sector(s). All other sec¬ 
tors after the damage cannot be accessed. As a result, it would be best to COPY 
the good files on the damaged diskette to a new diskette to avoid any further Pro¬ 
blems. 

If the file itself is damaged, you can also use the Get Byte program which wi II 
transfer each good sector from the damaged file into a recovery file. 


THE AUTORUN.SYS FILE 


When an AUTORUN.SYS file exists on the diskette in drive 1, that file is 
automatically loaded into RAM and executed (if appropriate) every time you boot 
the system. This entire process is completed betöre control of the System is return- 
ed to you. The AUTORUN.SYS file can be data; it can also be object code that is 
loaded, but not executed; or, it could be object code that is loaded and then ex¬ 
ecuted as soon as the load is complete. 

Figure 5-7 illustrates the use of AUTORUN.SYS to boot up directly into DOS 
even if a cartridge is present. After execution, AUTORUN.SYS normally returns to 
the DOS initialization routine. If during your application, it does not return, or if you 
allow the use of SYSTEM RESET betöre the return, the system initialization must be 
completed betöre proceeding. This is done by modifying two Operating System 
storage locations: COLDST at address 244 (Hex) and BOOT at address 9 (Hex). 
COLDST should be cleared to 00 and BOOT is set to 01. 
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The program] listed below sets these two locations to the proper value and then 
jumps indirectl^y to the Start DOS vector. 

It you do not: have an Assembler Editor cartridge, you can create the equivalent 
tile using BAS ICD POKE Statements and then saving the Binary File in DOS. The list 
of decimal nurmbers to be entered is as follows: 


Decimal Addr« 

15000 

15002 

15005 

15006 
15008 


Decimal Codes 

162, 0 
142, 68, 2 
232 
134, 9 
108, 10, 0 


When these codes have been entered in BASIC, type DOS RETURN to save the 
file using the SAVE selection from the DOS menu. 

Notice that tihere is no number entered for the INIT parameter. If you tum off 
your Computer and then turn it back on, your program should now boot up directly 
into DOS. To & nter BASIC, simply use the To-Cartridge function or press SYSTEM 
RESET. 

; Autorun PrograLm 
; Run DOS witho^ut going to cartridge. 

COLDST = $24-4 
BOOT = $09 
DOSVEC = $OA. 

* = 3A98 


(HEX CODE) 

DOSGO LDZX #0 A2 00 

STX COLDST 8E 44 02 

INIX E8 

STX BOOT 86 09 

JM IP (DOSVEC) 6C 0A 00 

* = $2E0 run address at 2E0 

. W^ORD DOSGO 98 3A 

. EPND 

Figure 5-7. An ^^UTORUN.SYS Example for the Advanced User 

Please refer to the use ot the SAVE function for detailed instructions on SAVEing 
this program. “The start, end, addresses to be specified are 3A98, 3AA2. For INIT 
address, simpD y press RETURN. For the RUN address, specify 3A98. 
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ADDITIONAL INFORMATION 
ABOUT THE DISK DRIVE SYSTEM 


ATARI DISKETTES 

ATARI Diskettes are thin mylar circular sheets covered with an oxide similar to that 
used on cassette tape. Each ATARI Diskette is 5 1/4 inches in diameter and each 
is sealed in a special black jacket designed to protect it from being bent, scrat<ch- 
ed, or contaminated. 

Each disk drive requires the diskette created specifically to operate with that 
drive. The ATARI 810 Disk Drive is a single-density drive and the ATARI 1050 D isk 
Drive can be used as single or a double-density disk drive. The essential differe nee 
between double-density diskettes and single-density diskettes is that the double- 
density recording technique requires a higher quality recording surface so that it 
can störe more data in the same space. Both types of diskettes are manufactu red 
in the same way. The difference is that the double-density diskettes have been 
pretested to guarantee performance with the double-density recording techniqu es. 
A blank double-density diskette should work as well on a single-density disk driv^e, 
but you should not use a blank, single-density diskette on a double-density disk 
drive. 

Once a diskette has been formatted for use with a single-density disk drive It 
cannot be used in a double-density disk drive unless you reformat the diskette een 
the double-density drive. The reverse is also true. If you have a System that us&s 
both types of drives and diskettes, be sure that you clearly label each diskette to 
show the type of drive on which it was formatted. 



ATARI 810 DISK DRIVE 

The ATARI 810 Disk Drive is a single drive with single-density recording 
capabilities. It uses Standard 5 1/4-inch flexible diskettes: ATARI 810 Master 
Diskette II (CX8104), ATARI 810 Blank Diskettes (CX81 00), and ATARI 810/81 5 
Blank Diskettes (CX8202), each of which Stores 90K (90 thousand) bytes. The 
ATARI 810 Disk Drive contains a built-in microprocessor which gives it an 
automatic stand-by capability. This means the disk drive motor is not in consta rat 
Operation, but waits to be “told” when it is needed. 


ATARI 1050 DISK DRIVE 

The ATARI 1050 Disk Drive unit can use a double-density recording technique. A 
track on a diskette created in double-density mode can störe 26 sectors insteaed of 
18 . 

Like the ATARI 810 Disk Drive, this drive also uses Standard 5 1/4 inch flexitole 
diskettes, but can störe 130K bytes on each diskette. The ATARI 1050 Disk Dn^ve 
has a built-in microprocessor to control the drive. 
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DISK DRIVE OPERATION 

When you insert a diskette into the disk drive, the spindle hole in the center is 
autom3tically placed on the drive hub and the diskette is seated. The circular 
diskette spins within its protective jacket. When you access the diskette, the 
magnetic head is placed over the read/write surface. 

When you störe data on a diskette, the disk drive converts the data it receives 
from the Computer console into coded electrical pulses. These pulses magnetize 
minute areas ot the oxide coating of each diskette while the diskette is spinning. 

When you retrieve data from a diskette, the disk drive positions the magnetic 
head so the area of the diskette where the data is stored passes beneath it. The 
disk drive’s microprocessor Controls the positioning and timing of the diskette. 
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ALPHABETIC DIRECTORY 
OF BASIC RESERVED WORDS 
USED WITH DISK OPERATIONS 


APPENDIX 



Note: The period is mandatory after all abbreviated keywords. 

RESERVED BRIEF SUMMARY 

WORD ABBREVIATION OF BASIC STATEMENT 

CLOSE 

CL. 

I/O Statement used to close a disk file at the 
conclusion of I/O operations. 

DOS 

DO. 

This command causes the menu to be 
displayed. The menu contains all DOS utility 
selections, Passes controi from cartridge to 

DOS Utilities. 

END 


Stops program execution, closes files, and 
turns off sounds. Program may be restarted 
using CONT. (Note: END may be used more 
than once in a program.) 

ENTER 

E. 

I/O command used to retrieve a listed pro¬ 
gram in untoken ized (textuai) form. If a pro¬ 
gram or lines are entered when a program is 
resident in RAM, ENTER merges the two pro- 
grams. If you don’t want programs merged, 
type NEW betöre using ENTER to load a pro¬ 
gram into RAM. 

GET 

GE. 

Used with disk Operation to input a single 
byte of data into a specified variable from a 
specified device. 

INPUT 

1 . 

This command requests data from a 
specified device. The default device is E: 

(Screen Editor), 

LIST 

L, 

This command Outputs the untokenized Ver¬ 
sion of a program to a specified device. 

LOAD 

LO. 

I/O command used to retrieve a saved pro¬ 
gram in tokenized form from a specified 
device. 

NOTE 

NO. 

This command Stores the current byte 
number of the file pointer in its two 
arithmetic variables. 

OPEN 

0 . 

Opens the specified file for input or output 
operations. Determines the type of opera¬ 
tions aliowed on a file. 

POINT 

P. 

This command is used in setting the file 
pointer to a specified location (byte) on the 
diskette, relative to the beginning of the file. 
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PRINT 

PR. or? 

I/O command causes output from the Com¬ 
puter to specified output device in record for- 
mat. 

PUT 

PU. 

Causes output of a single byte of data; i.e., a 
character, from the Computer to a specified 
device. 

RUN 

R. 

Both loads and Starts execution of 
designated filespec. 

SAVE 

S. 

I/O Statement used to record a tokenized Ver¬ 
sion of a program in a specified file on a 
specified device. 

STATUS 

ST. 

Calls Status routine for specified device. 

TRAP 

T. 

Directs execution to a specified line number 
in case of a program error, allowing user to 
maintain control of program and recover 
from errors. 

XIO 

X. 

General I/O Statement used in a program to 
perform DOS Menu selections and specified 
I/O commands. 
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NOTATIONS AND 
TERMINOLOGY USED 
WITH DOS 3 


APPENDIX j—^ 


SYSTEM RESET 
RETURN 

n 

U 

CAPITAL LETTERS 

/ • ■ ” 

> ■ 1 ■ » 


cmdno 

exp 


aexp 


aexpl 


aexp2 


filespec 


IOCB 


Press SYSTEM RESET key on the keyboard. 

Press RETURN key on the keyboard. 

Brackets. Brackets enclose optional items. 

Ellipsis. An ellipsis followimg an item in brackets in- 
dicates you can repeat the optional item any number 
of times, but are not requi red to do so. 

Braces. Items stacked vertically in braces indicate 
you have a choice as to which item you want to In¬ 
sert. Select only one to put in your Statement or com- 
mand. 

Capital letters are used to indicate commands, 
Statements, and other functions you must type exactly 
as they appear. 

Punctuation marks. These punctuation marks must be 
typed as shown in the format of a command or State¬ 
ment. However, do not type brackets or bracos. 

Command number. Used in XIO commands. 

Expression. In this manual, expressions are divided in- 
to three types: arithmetic, logical, and String expres¬ 
sions. 

Arithmetic expression. Generaiiy composed of a 
variable, function, constant, or two arithmetic expres¬ 
sions separated by an arithmetic operator (aop). 

Arithmetic expression 1. This arithmetic expression 
represents the first auxiliary I/O control byte when 
used in commands such as OPEN. 

Arithmetic expression 2. This arithmetic expression 
represents the second auxiliary I/O control byte when 
used in commands such as OPEN. Usualiy it is set to 
0. If, however, you want to direct the ATARI 820 
Printer to print sideways, you would set this 
arithmetic expression to 83. 

File specification. Usualiy a strong expression that 
refers to a file and the device where it is located, 
e.g.,“D1:MYPROG.BAS”for a file on Drive 1. 

Input/Output Control Block (IOCB). An arithmetic ex¬ 
pression that evaluates to a number from 1 to 7. The 
IOCB is used to refer to a device or file. IOCB 0 is 
reserved for BASIC for the Screen Editor and should 
only be used if the Screen Editor is not to be used. 
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lineno 

Line number, A constant that identifies a particular 
program line in a deferred mode BASIC program. A 
line number can be any integer from 0 through 
32767. Line numbering determines the order of pro¬ 
gram execution. 

var 

Variable. Any variable. In this manual, variables are 
classified as arithmetic variables (avar), matrix 
variables (mvar), or string variables (svar). 

avar 

Arithmetic variable. A location where a numeric value 
is stored. Variable names can be from 1 to 120 
alphanumeric characters, but must Start with an 
unreversed, uppercase alphabetic character. 

mvar 

Matrix variable. Also called a subscripted variable. An 
element of an array or matrix. 

svar 

String variable. A location where a string of 
characters may be stored. 
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ERROR MESSAGES 
AND HOW TO RECOVER 


APPENDIX 


Note: Error messages 2 through 21 should only occur when running a BASIC 
program. 


ERROR 

No. 

ERROR 

NAME 

CAUSE AND 

RECOVERY 

2 

Insufficient 

Memory 

You do not have enough memory to störe the State¬ 
ment, or to dimension a new string variable. Delete 
any unused variable names o r add more memory, 
(See Section 11, BASIC Refe rence Manual for 
memory Conservation.) 

3 

Value Error 

Either the expected positive ümteger was negative or 
the value was not within the expected ränge. 

4 

Too Many 
Variables 

You have exceeded the max i mum number (128) of 
variable names and must deüete any that are no 
longer applicable. (See Section 11, BASIC Reference 
Manual.) 

5 

String Length 
Error 

You have attempted to read Ifrom or write into a 
location past the dimensione^cd string size or you 
have used zeroas a reference index. Enlarge DIM 
size. Do not use zero as an Index. 

6 

Out of Data 

Error 

You do not have enough dato in your DATA 
Statements for the READ Statements. 

7 

Line Number 
Greater Than 
32767 

Check line number referencos in Statements such 
as GOTO and RESTORE. 

8 

Input 

Statement 

Error 

You have attempted to input: a non-numeric value 
into a numeric variable. Check your variable 
types and/or input data. 

9 

Array or 

String DIM 

Error 

The DIM size exceeds 5460 Tor numeric arrays 
or 32767 for strings; an arra^ or string was 
redimensioned; reference wos made to an undimen- 
sioned array or string. 

11 

Floating Point 

Overflow/ 

Underflow 

You have attempted to divicäo by zero or to 
refer to a number with an absolute value less 
than 1E-99, or greater than or equal to 1E-98. 

12 

Line Not 

Found 

A GOSUB, GOTO, or THEN referenced a non¬ 
existent line number. 

13 

No Matching 
FOR 

A NEXT Statement was encountered without a 
matching FOR. 

14 

Line Too 

Long Error 

You have exceeded the BASIC line Processing 
buffer length. 
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ERROR 

NO. 

ERROR 

NAME 

CAUSE AND 

RECOVERY 

15 

GOSUB or FÖR 
Line Delete<c± 

A NEXT or RETURN Statement was encountered 
and the corresponding FOR or GOSUB was deleted 
since the last time the program was run. 

16 

RETURN Er r or 

Check your program for a missing GOSUB 
Statement. 

17 

Syntax Erro r 

The Computer encountered a line with improper Syn¬ 
tax. Fix the line. 

18 

VAL Function 

Error 

The string in a VAL statment is not a numeric 
string. 

19 

LOAD Progr sel m 

Too Long 

You don’t have enough memory to load your 
program. 

20 

Device Nunmtoer 
Error 

You entered a device number that was not 
between 1 and 7. 

21 

LOAD File E r ror 

You attempted to load a nonload file, not a BASIC 
tokenized file. Tokenized files are created with the 
SAVE command. 


Note: The following are input/output errors that result during the use ot disk drives, 
Printers, or other accessory devices. Further Information is provided with the aux-' 
iliary hardware. 


128 

BREAK Abort 

User hit BREAK key during I/O Operation. Stops 
execution. 

129 

IOCB* Alreacci v 
Open 

OPEN Statement within a program loop or IOCB 
already in use for another file or device. 

130 

Nonexistent 

Device 

You have tried to access a device not in the 
handler table; i.e., the device is undefined. This error 
can occur when trying to access the ATARI 850™ 
Interface Module without running the RS-232-C 
HANDLER.SYS file. Another common occurrence of 
this error is specifying a filename without a device- 
i.e., “MYFILE” instead of “D:MYFILE.” 



Check your I/O command for the correct device. 
Then load and initialize the correct handler. 

*IOCB 

refers to Input/O loi tput Control Block. 

131 

IOCB Write-On ly 

You have attempted to read from a file opened for 
Write-Only. Open the file for read or update 
(read/write). 

132 

Illegal Flandle?r 
Command 

This is a CIO error code. The common Code passed 
to the device handler is illegal. The command is 
either < 2 or is a special command to a handler 
that hasn’t implemented any special commands. 
Check your XIO or IOCB command code for an il¬ 
legal command code. 

133 

Device/File 

Not Open 

You have not opened this file or device. Check 
your OPEN Statement or file I/O Statement for a 
wrong file specification. 
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ERROR ERROR CAUSE AND 

No. NAME _ RECOVERY _ 

134 Bad IOCB Number You have tried to use an iD legal IOCB index. For 

BASIC, the ränge is 1-7 els BASIC does not allow 
use of IOCB 0. The Assembler Editor Cartridge re- 
quires the IOCB index Io Boe a multiple of 16 and 
less than 128. 

135 IOCB Write-Only You have tried to write to a device or file that 

Error is open for Read-Only. Open the file for write or up¬ 

date (read/write). 

136 End of File Your input file is at end ol file. Not more data in file. 

137 Truncated Record This error typically occur s when the record you are 

reading is larger than tho maximum record size 
specified in the call to CI CD. (BASIC’s maximum 
record size is 119 bytes.> "Trying to use an INPUT 
(record-oriented) type of o ommand on a file that was 
created with PUT (byte-o t~ i ented) commands causes 
this problem. 

138 Device Timeout When you sent a commaLmd over the serial bus, the 

device did not respond vw? ithin the period set by the 
operating system for that device command. Either 
the device number is wrong or the user specified 
the wrong device; the de?>vtce is not there (wrong 
spec); it is unable to resp^ond within the proper 
period; or it is not connec ted. If the device is a 
cassette, the tape baud vr eite may have been 
mismeasured or the tap^ improperly positioned. 

Test all connections to nnake sure they are secure 
and check the disk drive to make sure it is turned 
on and set for the correto t drive number. Check your 
command for the correcd: drive number. Retry the 
command. If this error r&ours, have the disk drive 
checked. 

139 Device NAK The device cannot respo nd because of bad 

Parameters such as an L_jrnaddressable sector. The 
device might also have r eceived a garbled or illegal 
command or received inmproper data from the Com¬ 
puter. Check your I/O co mmand for illegal Para¬ 
meters and retry the command. Also check your I/O 
cables. This is a device s pecific error, so refer to 
the documentation for tl—r eit device. 

140 Serial Frame Bit 7 of SKSTAT in the POKEY Chip is set. This 

Error means that communicat ö on from the device to the 

Computer is garbled. 


This is a very rare error end it is fatal. If it occurs 
more than once, have ya ur device or Computer 
checked. You can also rr emove the peripherals one 
at a time to isolate the p^roblem. For cassettes, try 
the recovery suggested ln Error 138. 


ERROR ERROR 
NO. NAME 


CAUSE AND 
RECOVERY 


141 

142 

143 

144 

145 

146 

147 

160 

161 

162 

163 

165 


Cursor Out 
of Range 

Serial Bus 
Overrun 


Checksum Error 


Your Cursor is out of ränge for the particular 
graphics mode you chose. Change the pixel 
Parameters. 

Bit 5 of SKSTAT in POKEY is set. The Computer 
did not respond fast enough to a serial bus input In¬ 
terrupt or POKEY received a second 8-bit word on 
the serial bus betöre the Computer could process 
the previous word. This is a rare error. |f it occurs 
more than once, have your Computer serviced. 

The Communications ot the serial bus are garbled. 
The checksum sent by the device is not the same 
as that cafculated for the frame received by the 
Computer. There is no Standard recovery procedure 
because it couid be either a hardvvare or Software 
Problem. 


Device Done Error The device is unabfe to execute a valid command. 

You have either tried to write to a write-protected 
diskette or device, or the disk drive is unabfe to 
read/write to the requested sector. Remove the 
write-protected tab or turn off the write-protect 
switch. See specific manuals for other device. 


illegal Screen 
Mode 

Function Not 
Implemented 


Insufficient RAM 


Drive Number 
Error 


You have tried to open the Screen Editor with an 
illegal graphics mode number. Check your graphics 
mode call or the aux2 byte in the IOCB. 

The handier does not contain the function; e.g., 
trying to PUT to the keyboard or issuing special 
commands to the keyboard. Check your I/O com¬ 
mand for the right command and the correct device. 

Not enough RAM for the graphics mode you 
seiected. Add more memory or use a graphics mode 
that doesn’t require as much memory. 

You specified a drive number that was not 1-8, did 
not aliocate a buffer for the drive, or your drive was 
not powered up at boot time. Refer to Section 1 of 
this manuai. Check your filespec or byte 1802 for 
number of drive buffers allocated. 


Too Many 
OPEN Files 


Disk Full 


You don’t have any free system buffers to use on 
another file. Make sure no files are open that should 
not be open. 

You don’t have any more free blocks on this 
diskette. Use a different diskette that has free 
biocks. 


Unrecoverable This error means that the File Manager has a bug 

System I/O Error in it. Your DOS or the diskette may be bad. Try 

using other DOS. 

File Name Error Your file specification has illegal characters in it. 

Check filespec and remove illegal characters. 
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ERROR 

NUMBER 

ERROR 

NAME 

CAUSE AND 

RECOVERY 

167 

File Protected 

You have tried to access a protected file for pur- 
poses other than reading i"L Use DOS Menu Option 

U to unlock the file and re*try your command. 

168 

Device Command 
Invalid 

You issued an illegal command to the device 

Software interface. Check the documentation for 
that device and retry the command. 

169 

Directory Full 

You have used all the spa ce allocated for the Direc¬ 
tory. 

170 

File Not Found 

You have tried to access a file that doesn’t exist in 
the diskette’s Directory. U se DOS Menu Option F to 
check the correct spelling of the filename and to be 
sure it is on the diskette you are accessing. 

171 

POINT Invalid 

The byte count in the POirslT call was greater than 
the number of bytes in the file. Check the 

Parameters in your POINT Statement. 

173 

Bad Sectors at 
Format Time 

The disk drive has found toad sectors while 
formatting a diskette. Use another diskette, as you 
cannot format a diskette with bad sectors. If this er¬ 
ror occurs with more than one diskette, your disk 
drive may need repair. 

174 

Duplicate 

Filename 

You performed a RENAME funct that would result 
in two files of the same name on the diskette. Since 
DOS 3 is not able to teil w^hich of them you want to 
use for the next Operation involving that name, it 
refuses to execute this specific rename command. 
Solution: Use a different m ame for the rename, or if 
you no longer need the offner file, erase it. 

175 

Bad Load File 

The file which you asked DOS 3 to load is not a 
ioad-type file. 

176 

Incomaptible 

Format 

You are trying to perform a DOS 3 Operation 
using a DOS 2 diskette. U se the f unction cailed 
ACCESS DOS 2 to transla*te your file for further use 
with DOS 3. 

177 

Disk Structure 
Damaged 

DOS 3 does not recognize? the files on the disk 
due to some form of damage to the disk, whether 
electrical, mechanical or use of a non-DOS 3 disk 
itself. 

Note: the errors 2 throughn 10 listed below can occur 
only during DOS 3 menu sefection operations. 

2 

No Command 

No file with an extender of .CMD exists in drive 1. 

3 

Input Required 

You have tried to enter a blank for the new name in 
a Rename command or some other similar item 
where there is no default. If an in put is required, you 
must provide it. Check the HELP screens to see 
what kind of input is neecäed. 
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ERROR 

No. 

4 

5 

6 

7 

8 

9 

10 
128 


ERROR CAUSEAND 

NAME RECOVERY 


No Cartridge 


I/O Error 

Invalid End 
Address 

Error Loading 
MEM.SAV 


Error Saving 
MEM.SAV 


Drive Input Error 

Filename Input 
Error 

BREAK abort 


You have executed the TO-CARTRIDGE function 
wi th no cartridge present. You have to power-down 
amd install the cartridge to be able to execute this 
fumction. 

Scame I/O error (e.g., printer is not on line for a print 
Operation) occurred. 

You have given an END address for the SAVE func- 
tio n which is less than the Start address. Check you 
en try and try again. 

Th e System has been unable to restore the memory 
us ^ng the MEM.SAV file. The program which you had 
in memory when you typed DOS, is lost. This error 
may mean a faulty diskette or a dirty drive. Check 
thst the file MEM.SAV is on the diskette in drive 1. 

So mething has happened while the System was trying 
to write the MEM.SAV file. This file is not valid on 
tho disk. You might try installing a different disk for 
tho next time. There is no possible recovery from 
this probiem. 

Yoqj supplied an invalid device specification. 

Yoelj supplied an invalid filename. 

Yoou have touched the BREAK key during one of the 
operations and the function was stopped. Decide 
wh ich function you wish and repeat it, without a 
BR EAK. 
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DOS 3 MEMORY MAP 


APPENDIX 



ADDRESS 

CONTENTS 


Decimal Hexadecimal 



65535 

FFFF 

OPERATING SYSTEM 


49152 

cooo 



49151 

BFFF 

CARTRIDGES 


32768 

8000 



32767 

7FFF 

SCREEN DISPLAY AREA 


varies 




varies 


USER PROGRAM AREA 

HIMEM** 

varies 



LOMEM* 




UTILITY 



System Buffer N 

PROGRAMS 




and 




BUFFER AREA 



System Buffer 2 

RESERVED 

6780 

1A7C 

System Buffer 1 

FOR DOS 3 

6779 

1A7B 





KEYBOARD COMMAND PROCESSOR (KCP) 



(RAM RESIDENT PORTION OF KCP) 


5728 

1660 


5727 

165F 

FILE MANAGEMENT SYSTEM (FMS) 


1792 

0700 


1791 

06FF 




0600 

USER RAM 



05FF 



0 

0000 

OPERATING SYSTEM RAM 



* Varies with the number of System Buffers reserved. (See INIT Function.) 

**Depends on which Graphics Mode is currently in use. 

Note 1: For given System Buffer allocation, LOMEM can be determined by PEEK 
Locations 2E7 (LOW) and 2E8 (HIGH) Hex or 743 (LOW) and 744 (HIGH) Decimal. 

Note 2: To determine the amount of User Program Area av'ailable or HIMEM, you 
can either make use of the BASIC FRE(O) instruction or PEEK Locations 2E5 (LOW) 
and 2E6 (HIGH) Hex or 741 (LOW) and 742 (HIGH) Decimal. 
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HEXADECIMAL TO DECIMAL 
CONVERSION TABLE 

APPENDIX 

FOUR HEX DIGITS 

4 3 2 1 

HEX DEC HEX DEX HEX DEC 

HEX DEC 



0 

0 

0 

0 

0 

0 

0 

O 

1 

4096 

1 

256 

1 

16 

1 

1 

2 

8192 

2 

512 

2 

32 

2 

2 

3 

12288 

3 

768 

3 

48 

3 

3 

4 

16384 

4 

1024 

4 

64 

4 

4 

5 

20480 

5 

1280 

5 

80 

5 

5 

6 

24576 

6 

1536 

6 

96 

6 

6 

7 

28672 

7 

1792 

7 

1 12 

7 

7 

8 

32768 

8 

2048 

8 

128 

8 

8 

9 

36864 

9 

2304 

9 

1 44 

9 

9 

A 

40960 

A 

2560 

A 

1 60 

A 

IO 

B 

45056 

B 

2816 

B 

1 76 

B 

1 1 

C 

49152 

C 

3072 

C 

1 92 

C 

12 

D 

53248 

D 

3328 

D 

206 

D 

13 

E 

57344 

E 

3584 

E 

224 

E 

14 

F 

61440 

F 

3840 

F 

240 

F 

15 

*Use this table to convert up to four hex digits. 




For example, to convert the hex number 1234 to decimal, 

add the entries from 

each of the four columns in the table. 

For 1, use the column number 4, and so 


1234 hex. = 4096 
+ 512 

+ 48 

+ 4 

4660 dec. 


Other examples: 

EEDD hex. = 57344 
+ 3584 

4- 208 

+ 13 

61149 dec. 

AB hex. = 160 
+ 11 

171 dec. 
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HOW TO SPEED UP DATA 
TRANSFERS TO DISK DRIVE 


APPENDIX 



Your new DOS 3 has the ability to Write and Read Verify (a safety technique that 
should be used whenever improved reliability is more important than rapid data 
transmissions). This is the way your DOS 3 Master Diskette is shipped to you. To 
save time, however, the Information can be written to the diskette without a Read 
Verify. Düring disk initialization, the File Management Subsystem may be modified 
to either use write with verify or write without verify. Write without Read Verify is 
faster, but may not be as reliable. 

To alter the version of DOS stored on diskette so that your custom Version will 
always boot in, simply type DOS and then use the I (Init Disk) command from the 
Disk Operating System Menu and answer Yes to the question “Modify FMS 
Parameters?'’ to störe the new version of DOS from RAM onto your diskette. 
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MAJOR DIFFERENCES 
BETWEEN DOS 3 AND DOS 2 


APPENDIX 


1. The DOS 3 file manager and buffers now take up less space than the DOS 2 
equivalents. All Utilities, such as COPY, IN IT, DUPLICATE (all UTL files) are 
called into memory only as needed. Each is maintained in a separate file. 

2. DOS 3 provides a direct method for the user to modify the FMS Parameters 
(shown in the description of the INIT function). 

3. DOS 3 provides an online HELP feature that was not available on DOS 2. 

4. The NOTE and POINT commands return a pointer number relative to the Start of 
a file (byte 0) rather than an absolute sector and byte location within the sector . 

If both the sector variable and the byte variable are stored for future use, pro¬ 
gram compatibility can be maintained. In other words, if the DOS 2 conventions 
are followed, programs can run on either DOS 2 or DOS 3. 
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STRUCTURE OF 
A COMPOUND FILE 


ARF*ENDIX |_| 


COMPOUND FILE STRUCTURE 


Decimal Hex 


Byte No. 

No. 

No. 

1 

255 

FF 

2 

255 

FF 

3 

0 

00 

4 

80 

50 

5 

31 

1 F 

6 

80 

50 


38 

255 

FF 

39 

255 

FF 

40 

32 

20 

41 

80 

50 

42 

143 

8F 

43 

80 

50 


COMPOUND FILE STRUCTURE 

Decimal Hex 

Byte No. 

No. 

No. 

1 

255 

FF 

2 

255 

FF 

3 

00 

00 

4 

80 

50 

5 

31 

1 F 

6 

80 

50 


38 

32 

20 

39 

80 

50 

40 

143 

8F 

41 

80 

50 


USING COPY/APPEND 
Description 

Identification Code (PART 1) 

Starting Address (PART 1) 

Ending Address (PART 1) 

DATA (PART 1) 

32 Bytes 

Identification Code (PART 2) 

Starting Address (PART 2) 

Ending Address (PART 2) 

DATA (PART 2) 

112 Bytes 

USING SAVE 

Description 

Identifier Code 

Starting address (PART 1) 

Ending address (PART 1) 

Data (PART 1) 

32 Bytes 

Starting address (PART 2) 

Ending address (PART 2) 

Data (PART 2) 

112 Bytes 
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GLOSSARY 
OF TERMS 


APPENDIX 


Access 


Address 

Alphanumeric 


Array 


ATASCII 


AUTORUN.SYS 

Baud Rate 

Binary 

Bit 

Block 

Boot 


The method (or Order) in which Information is read 
from, or written to diskette. See Sequent ial Access 
and Random Access. 

A location in memory, usually specified by a two- 
byte number in hexadecimal or decimal iformat. 
(Maximum ränge is O-FFFF hexadecimal.) 

The letters A-Z and the numbers 0-9, and/or com- 
binations of letters and numbers. Specifioally ex- 
cludes graphics symbols, punctuation marks, and 
other special characters. 

A one-dimensionaö set of elements that c an be 
referenced one at a time or as a commp Dete list by 
using the array va riable name and one SLJfoscript. 
Thus the array B, elem<ent number 10 would be 
referred to as B(IO). Note that string arrays are not 
supported by BASIC, but you can pick up each eie- 
ment within a string; for example, A$(10). All arrays 
must be dimensioned before use. A matri x is a two- 
dimensional array. 

The method of coding used to störe extennal data. In 
ATASCII (which is a modified version of A*SCII, the 
American Standard Code for Information Inter¬ 
change), each character and graphics syrmbol, as 
well as most of the control keys, has a niurmber 
assigned to represent it. The number is a one-byte 
code (decimal 0-255). See the ATARI BASIC 
Reference Manual for table. 

Filename reserved for use by user. If 
AUTORUN.SYS is on disk being booted, \t will be 
loaded into RAM. 

Signaling speed or speed of Information imterchange 
in bits per second. 

A number base System using the digits 0 smd 1. 

Abbreviation of “binary digit.” The smallest unit of 
Information, represented by the value 0 or - 1 in 
binary. 

A total of 8 sectors, treated as a group by- the File 
Manager. 

This is the initialization program that “sets up” the 
Computer when it is powered up. At conclsusion of 
the boot (or after “booting up”), the comp uter is 
capable of loading and executing high level pro- 
grams. 
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Break 

Buffer 


Byte 

Cartridge 

CIO 

CLOSE 

CONVERT.UTL 

COPY-UTL 

Data 

Debug 

Decimal 


Default 


Delimiter 

Density 

Destination 

Directory 

Disk Drive 
Diskette 


DOS 


To? interrupt execution of a program. Pressing the 
BF-^tEAK key causes a break in execution. 

A “Tremporary storage area in RAM used to hold data 
for- further processing, input/output operations, and 
th^3 like. 

Ei czza ht bits. A byte can represent one character. A 
has a ränge of 0-255 (decimal) or 0-FF (hex). 

Arr assembly containing a read-only memory (ROM). 
Us «jally intended to contain an executable program. 

Ce mtral Input/Output Subsystem. The part of the OS 
thg^ t handles input/output. 

To terminate access to a disk file. Betöre further ac- 
cess to the file, it must be opened again. See OPEN. 

Fil€=* containing the ACCESS DOS 2 Utility. 

Fil^s containing the COPY utility. 

inf <cmrmation of any kind, usually a sequence of bytes. 

To isolate and eliminate errors from a program. 

A m umber base System using the digits 0 through 9. 
De c^imal numbers are stored in Binary Coded 
Dezimal format (or in binary format) in the com- 
put: «ier. See Bit, Binary, Hexadezimal, and Octal. 

A ondition or value that exists or is caused to exist 
b y ~Gzhe Computer until it is told to do something eise. 
For - example, the Computer defaults to GRAPHICS 0 
unt d I another graphics mode is entered. 

A cg Eharacter that marks the Start or finish of a data 
iterrrn but is not part of the data. For example, the 
quc3 tation marks (”) are used by most BASIC 
Systems to delimit Strings. 

The closeness of space distribution on a storage 
megrzdium; the number of sectors per diskette. Single- 
deru sity is 720 sectors per diskette; double-density is 
1 04- CD sectors per diskette. 

The device or address that receives data during an 
exo ETnange of Information (and especially an I/O ex- 
ch sl tnge). See Source. 

A p«=3rtion of a diskette containing a summary of files 
con “Szained on a diskette by filename, file size, and 
locs&- lion. 

A d^^vice for reading and writing disks. 

A sf—mall disk. A record/playback medium like tape, 
but rmade in the shape of a flat disk and placed in 
an nvelope for protection. The access time for a 
disk^stte is much faster than for tape. 

Abt> meviation for Disk Operating System. The soft- 
war^^ or- programs that facilitate use of a disk drive 
syst 
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Drive Specification 
or Drivespec 

Drive Number 

DUPDISK.UTL 
End of File 

Entry Point 

Fife 


File index 
Filename 

Filename Extender 
or Extension 


File Pointer 
Filespec 


FMS.SYS 

Format 


HÄNDLER.SYS 

HELP.TXT 

HELP.UTL 

Hexadecimal or Hex 


Indexed Addressing 
INIT.UTL 


Part of the filespeo that teils the Computer which 
disk drive to access. If this is omitt<£3d the Computer 
will assume Drive 1. 

An integer from 1 to 8 that specifies the disk drive to 
be used. 

File containing the DUPLICATE utilitv- 

A marker that teils the Computer that the end of a 
certain file has been reached. 

The address where execution of a nmachine-language 
program or routine is to begin. Also ecalled the run ad¬ 
dress. 

An organized colleotion of related data. A file is the 
largest grouping of Information that can be addressed 
with a single name. For example, a BASIC program is 
stored on diskette as a particular file , and may be ad¬ 
dressed by the Statements SAVE or LOAD (among 
others). 

Listing of file name and size directory information. 

The alphanumeric oharacters used to identify a file. A 
total of eight numbers and/or letters may be used. 

From 0 to 3 additional oharacters used following a 
period (required if thie extender is used) after the 
filename. For example, in the filenanme 
PHONLIST.BAS the letters "BAS" comprise the ex¬ 
tender. 

A pointer to a location in a file. Each file has its own 
pointer. 

Abbreviation for file specification. A sequence of 
oharacters which specifies a particul ar device and 
filename. Consists of a drive spec an d a file name 
and optional file name extension. 

Filename containing the File Management System. 

To organize a new or magnetically (t>ulk) erased 
diskette onto tracks and sectors. When formatted, 
each diskette contains 40 circular tracks, with 18 or 
26 sectors per tracK. Each sector can störe upto128 
bytes of data. 

File name reserved for use by DOS 3 similar to 
AUTORUN.SYS. 

File containing help information. 

File containing the HELP Utility. 

Number base System using 16 alphanumeric 
oharacters 0,1,2,3,4,5,6,7,8,9AB,C,D S E, and F. Ad- 
dresses and byte values are sometinmes given in hex. 

See Random Accessing. 

File containing the fl NIT Utility. 


Input 


INPUT 

I/O 

IOCB 


iocb 


KCP.SYS 

KCPOVER.SYS 


Kilobyte or K 


Least Significant 
Byte 

LOAD 


Machine Language 

Most Significant 
Byte 

Null String 
Object Code 
Octal 
OPEN 


Parameter 

Peripheral 

POKEY 


To transfer data from Outside the Computer (say, from 
a diskette fiie) into RAM. Output is the opposite, and 
the two words are often used together to describe 
data transfer operations: Input/Output or just I/O. 
Note that the reference point is always the Computer. 
Output always means away from the Computer, while 
Input means into the Computer. 

A BASIC command used to request either numeric or 
stri ng data from a specified device. 

Input/Output. 

Input/Output Control Block. A section of RAM 
reserved for addressing an input or output deyice and 
Processing data received from it or for addressing 
and transferring data to an output device. 

An arithmetic expression that evaiuates to a number 
between 1 and 7. This number is used to refer to a 
devil ce or file. 

File containing the resident portion of the keyboard 
com mand processor. 

File containing non-resident portion of the keyboard 
com mand processor. 

1 024- bytes. Thus a 16K RAM capacity actually gives 
us 16 times 1024 or 16,384 bytes. 

The byte in the rightmost Position in a number of a 
word. 

To read from a diskette file into memory. Usually con- 
sists of an executable object file or direct machine- 
reaciable Code. 

The i nstruction set for the particular microprocessor 
Chip used, which for ATARI is the 6502. 

The fc>yte in the leftmost position in a number or a 
worci. 

A stri ng consisting of no character whatever. For ex- 
ample, A$””Stores the null String in variable A$. 

Mach ine language derived from “source code," 
typicstlly from assembly language. 

The octal numbering System uses the digits 0 
throu gh 7. 

To propare a file for access by specifying whether an 
input or output Operation is to be conducted, and 
specifying the filespec. 

Variables in a command or function. 

An I/O device. 

A custom I/O Chip that manages communication on 
the so rial bus. 
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Random Access 

Record 

SAVE 

Sector 

Sequential Access 
Source 
Source Code 

String 

System buffer 
System Diskette 

Tokenizing 

Track 

Variable 

Write-Protect 


The method of reading data from a dis kette directly 
from the byte and sector where it was stored without 
having to read the enti re file sequentially. 

A block of data, deiimiited by an EOL (End-Of-Line, 9B 
Hex) character. 

To write from memory to diskette. Consists of either 
machine-readable codo or an executable program. 

A sector is the smallest block of data that can be 
written to a disk file or read from a file. Each sector 
can störe 128 bytes of data. 

The method of reading each byte from the diskette in 
order, starting from tho first byte in the sector. 

The device or address fhat contains the data to be 
sent to a destination. See Destination. 

A series of instructions„ written by the user. Needs to 
be translated to machi ne language in order to be 
executed. 

A sequence of letters, oharacters, stored in a string 
variable. The string va rriable’s name must end 
with a $. 

A buffer used by FMS. Each device and each open 
file require one System buffer. 

An exact backup copy of original Master Diskette. 
Always use backup copies of your Master Diskette in- 
stead of the original. Keep backup copies of all 
important data and program diskettes. 

The process of interpr eting textual BASIC source 
code and converting it: to tha internal format used by 
the BASIC Interpreter. 

A circle on a diskette used for magnetlc storage of 
data. Each track has H 8 or 26 sectors, each with 
128-byte storage cape.bility. There are a total of 40 
tracks on each diskette. 

A variable may be tho ught of as a box in which a 
value may be stored. Such values are typicaliy 
numbers and strings. 

A method of preventirag the disk drive -from writing on 
a diskette. ATARI diskottes are write-protected by 
covering a notch on tbie diskette cover with a small 
sticker. 
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ERROR 
CODE NO 

2 

3 

4 

5 

6 

7 

8 
9 

10 

128 

130 

136 

138 

139 

140 

141 

142 

143 

144 
160 
161 
162 
163 
165 

167 

168 

169 

170 

171 

173 

174 

175 

176 

177 


ERROR CODE MESSAGE 

No command File Found 
Input Required 
No Cartridge 
I/O Error 

Invalid End Address 

Error Loading MEM.SAV 

Error Saving MEM.SAV 

Device Specification Input Error 

Filename Input Error 

Break Abort 

Nonexistent Device 

End of File 

Device Time Out 

Device NAK 

Serial Bus Input Framing Error 

Cursor Out of Range 

Serial Bus Data Frame Overrun Error 

Serial Bus Data Frame Checksum Error 

Device Done Error 

Device Number Error 

Too Many Open Files 

Disk Full 

System I/O Error 

Filename Error 

File Protected 

Special Command Invalid 

Directory Full 

File Not Found 

Point Invalid 

Bad Sectors at Format Time 
Duplicate File 
Bad Load File 
Format Incompatible 
Disk Structure Error 
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Boldface page numbers refer to sections discu ssing the item indexed. 


A 

Access DOS 2, 15, 23 , 39, 45, 52, 81, 94 
Accessing damaged files, 69 
Address, 37, 42-44, 50, 51, 57, 70, 82, 91, 
93 

Additional disk drives, 2 
Aexp, 75 
Aexpl, 75 
Aexp2, 75 
Alphanumeric, 93 
Appendices, 73 
Array, 93 

ATASCII, 55, 56, 93 
AUTORUN.SYS file, 69 , 93 
Avar, 76 

B 

BASIC commands, 55 
BASIC error messages, 77 
BASIC words used, 73 
Baud rate, 79, 93 
Binary load, 11 
Binary save, 1, 70 
Bit, 80 
Boot, 93 

Boot errors, 3, 12 
Break, 94 
Buffer, 94 

Byte, 19, 21, 35, 42, 59-64, 69, 73, 74, 75, 
79, 80, 91,93, 94, 95, 97 

C 

CIO, 94 

CLOSE command, 57 , 67, 73, 94 
Cmdno, 75 

Commands, 7-9, 10 , 13, 23-44 passim, 
50-65 passim, 75-82 passim 
Compound file structure, 91 
Control blocks, 57 
Copy file, 25 , 69 
Creating MEM.SAV, 45 
Creating a System diskette 
Using an ATARI 810 Disk 
Drive, 12-13, 20, 71 
Using an ATARI 1050 
Dual Disk Drive, 20, 12-13, 1 

D 

Daisy-chaining, 2 
Data, 94 
Data files, 1,11 

Data transfer to disk drives, 87 


Debug, 

Decimal r 94 

Default, T , 10, 19, 23-27, 31-59 passim, 
73, 82, 94 
Delimiter, $?4 
Density, 99^4 
Destinat äo>m drive, 29-32, 94 
Differencce«s between DOS 3 and DOS 2, 
89 

Directorv= «81,94 
Disk drnv-^s, 1, 2 - 3 , 4-5, 12-23 passim, 
29-30, ^4 4 , 71 , 72, 78-82, 94 
Disketten 1 , 3 , 5, 10-15, 17 , 19-34 passim, 
39-50 p>sissim, 63-97 passim 
Disk Operating System (DOS), 1, 7 
DOS com nnand, 23, 39, 73 
DOS menu , 4, 5, 9, 14, 17, 23, 28, 38, 39, 
42, 45 , 46, 52, 67, 68, 70, 73, 81 
DOS menu options, 67 
Double cäe?msity, 12, 19, 21 
Drive Codes, 2, 3, 13, 20 
Drive number, 24, 25, 29-31,39, 43, 44, 
79, 80 , 95 

Duplicate f 5le, 25-28, 49, 81,98 
Duplicairi 055 a diskette, 20, 29 

E 

END connmand, 73 
End of f Mo, 95 
ENTER connmand, 55-56,73 
Entry poi ml ^ 95 

Error code messages, 16, 21, 58, 77 
Exp, 75 

F 

File, 4, TT 4 4, 17, 20, 23, 28-73 passim, 
84-98 passim 

File Management System (FMS), 4, 7, 42, 
80 

Filenamee „ S, 11, 24-54 passim, 63-78 
passim, 95 

Filenarme extenders, 11 - 12 , 37, 49, 95 
File point o r ^ 95 

Filespec , TT 8, 11, 24-67 passim, 75-75, 

95 

Formatti nc; a diskette, 13, 18, 19 , 29, 

40, 95 

G 

GET command, 57, 62 , 73 
Glossary' ol terms, 93 


H 

Hexadecimal, 50, 85, 93, 95 

I 

Identifying diskette fites, 10 
Input, 58, 82, 96 

INPUT/OUTPUT commands, 57-59, 63, 67, 
73, 96 

IOCB, 57-61, 67, 75, 79, 96 
#iocb, 57, 58, 61, 96 

K 

Kilobyte, 96 

L 

Labeling disk drives, 3 
Labeling diskettes, 21 
Least significant byte, 96 
Lineno, 76 

LIST command, 46, 55-56, 73 
LOAD command, 55, 96 

M 

Master diskette, 2-4, 7, 13, 17 , 18-20, 
31-32, 35, 38, 48, 87, 97 
Memory map, 83 

MEM.SAV, 15, 20, 45 Creating MEM.SAV, 
45 

Menu, 4 , 7, 9, 14 , 16 , 18, 19, 25, 33-53 
passim, 64, 67, 81 
Most significant byte, 96 
Mvar, 76 

N 

Notations and terminology, 75 
NOTE command, 60, 61, 73, 89 
Null string, 96 

O 

Object codes, 96 
Octal, 96 

OPEN command, 42, 57 , 67, 73, 96 

P 

Parameters, 1, 19-20, 41-42, 79-80, 87, 89, 
96 

Peripheral, 96 

POINT command, 60 , 61, 73, 89 
PRINT command, 58 , 59, 74 
Protected fite, 81 
PUT command, 57, 62 , 63, 74 

R 

RAM, 1,17, 20, 73, 80, 94 
Record, 74, 97 
Rename, 47, 49-50, 67, 81 
RUN address, 44, 51,64 
RUN command, 74 


S 

SAVE command, 50, 55-56, 78 
Sector, 7, 13, 18, 19, 21, 81,89, 93, 97 
Sequentia! access, 97 
Single density, 19, 21, 41, 43, 71 
Conversion of single density to double 
density, 41 
Source code, 97 
STATUS command, 63 , 64, 74 
String, 76-77, 93, 97 
Svar, 76 

System diskette, 13, 18, 20 , 41, 97 

T 

Tokenized file, 55 , 74, 78, 97 
Track, 7, 18-19, 97 
TRAP command, 64, 74 

U 

Untokenized fite, 55 , 73 

V 

Variable, 76, 89, 97 

W 

Wildcards, 8 , 24-27, 29, 32-34, 36, 39, 

44, 47-49, 53, 65, 68 
Write-protecting a diskette, 3, 20, 24 
30-32, 47, 97 

X 

XIO command, 65-66, 67 , 74, 75 
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